home *** CD-ROM | disk | FTP | other *** search
/ Hand Picked Software / Hand Picked Software.iso / graphics / gds / gds.txt < prev    next >
Text File  |  1995-03-13  |  202KB  |  5,134 lines
  1.  
  2.             █████▀█▀█▀█▀▄▀▄▀ ▄▀▀▀▀C▀▀▀██
  3.             █▀▄▀▄▀▄▀▄▀█▄▀▀▀C▄▄▄▄▄▄▄▄▀
  4.             █▀▄▀▄▀▄▀▀C▄ ▄▄▄▄▄█▀▄█▀▄  ▄▄
  5.             █▀▄▀C▄ ▄▄▄▄▄▄▀ ▄▀▀▀▄█▀▄▄▀▄
  6.             ▀ C▄▀▄▄ █▀▀▀ ▀██▄▄ ▀▀▀▄▀▄▀█
  7.              ▀▄▀▀   C██▀█▄▄▄▄█▀██▀ ▄ ▀▀▄▀▄██
  8.              ▄▀▄▄▀▀ █▀▀▀▄▀▄▄▀▄▀▀▀▄▄▀▀▄▀▄▀▄██
  9.             ▀▄ ▀▄▀▄▄▄▀▄▄▄▀ ▀ C▄▀ ▄▀▄▀▄▀▄█▄██
  10.             ▀▄ ▀▄▀▄▀▀▀█▄▀▄▀▄▀▄█▄█▄▀▀▀▀██████
  11.             █▄▄█▄▀ ▄█  ▄▀C█▄ ▀██  █▄C▄▀████
  12.             ████▀ ▄▄█▄ ▄█  ██▄ ▀█  █████████
  13.             ▀▀▀▀C▀▀▀▀▀▀▀C▀▀▀C▀▀▄ ▀▀▀▀▀▀▀▀
  14.             ▄▄▄▄C▄▄▄C▄▄C▄▄▄C▄▄▄▄▄ ▀▄▄▄▄▄
  15.             ████▄ ▀▀█  ██  ██▀  █████   ████
  16.             █████▄ ▀▀  ██  █▀ ▄█▄C▀█▀   ████
  17.             ███████▄▄▄▄█▄▄▄▄▄ ▄███▄▄▄▄█▄████
  18.  
  19.      GDS.TXT - This is a data file.  DO NOT modify or distribute separately.
  20.  
  21.     Copyright (c)1991-95 Photodex Corporation.  All rights reserved.
  22.       Photodex is a registered trademark of Photodex Corporation.
  23. 
  24.  
  25.  
  26. Tampering with this file is a violation of federal copyright laws and
  27. international treaties.  Violators will be prosecuted to the fullest
  28. extent of the law.
  29.  
  30.  
  31.  
  32. :::catRes
  33.  
  34. (press 'Esc' to cancel)
  35.  
  36.  
  37. Select Catalog Image Resolution:
  38.  
  39. A- 320x200
  40. B- 640x400
  41. C- 640x480 (default)
  42. D- 800x600
  43. E- 1024x768
  44. F- 1280x1024
  45.  
  46. Which? :::catFType
  47. Select Catalog File Type
  48.  
  49. G- GIF (16 to 256 colors)
  50. J- JPEG (24 bit/16M colors)
  51.  
  52. Which? :::catDepth
  53. GIF89a
  54.  
  55. Select GIF Catalog Bit Depth
  56.  
  57. A- 4 bit / 16 colors
  58. B- 8 bit / 256 colors
  59.  
  60. Which? :::cat24
  61.  
  62.  
  63. There are 24 bit files in this batch. Palette optimization requires more
  64. processing.  JPEG files require 5-10 seconds more per file to process
  65. because of redundant decompression.
  66.  
  67.  
  68. Select Palette Quality
  69.  
  70. A- Lame (fast, but image quality is not great)
  71. B- Best possible palette (a bit slower, but the wait is worth it)
  72.  
  73. Which? :::catStyle
  74.  
  75. Select GDS Catalog Style
  76.  
  77. A- Black, no borders
  78. B- Black with borders
  79. C- White, no borders
  80. D- White with borders
  81. E- Gray, no borders
  82. F- Gray, 3D borders (default)
  83.  
  84. Which? :::catLay
  85.  
  86. Select GDS Catalog Layout (%d files)
  87.  
  88. :::catNoVirt
  89.  
  90. Not enough memory for virtual screen file.  Catalog cannot be generated.
  91.  
  92. Press any key to continue.
  93. :::catFinal
  94.  
  95.  
  96.  
  97. If you have not seen a recent copy of GDS, you should!  GDS has been given
  98. a new look and overhauled by Photodex, and is now the most complete graphics
  99. file viewer/cataloger in the world.  It has the fastest viewing capabilities
  100. and user interface of any mainstream graphics programs.  Better yet, GDS out-
  101. does just about every other file viewer, file cataloger, or file converter!
  102. GDS is now used by professionals worldwide to manage thousands of graphics
  103. files every day.  Become a graphics professional -- Discover GDS.
  104.  
  105. Search this system for GDS*.ZIP or GDS*.EXE to get the best file viewer ever.
  106. GDS is shareware, affordable, and registration help is always included.
  107.  
  108. Generating GDS catalog, this takes a minute or two...(Press 'Esc' to cancel)
  109.  
  110. :::vidType
  111.  
  112.  
  113. Ready to attempt detection of video hardware.  NOTE: Some notebooks crash
  114. during video detection.  If the screen locks up after you press [Enter]
  115. (give it 10-20 seconds), simply reboot and use one of the numbers or letters
  116. here. See the help system for more information, or the end of GDS.TXT if
  117. you are familiar with low level video hardware.
  118. (Video types marked with '*' may not be 100%% detectable on all machines.)
  119.  
  120.  1-HERC  *5-AHEAD    *9-CIRRUS    D-F1280   H-SS24X    *L-TSENG    P-ST64
  121.  2-CGA    6-AHEADB   *A-CL54      E-GENOA   I-STEALTH  *M-TSENG4
  122.  3-EGA    7-ATI      *B-EVEREX   *F-OAK     J-STPRO    *N-VESA
  123. *4-VGA    8-CHIPS     C-EV634    *G-PARA   *K-TRIDNT    O-VIDEO7
  124.  
  125. Press [Enter] for automatic detection,
  126. or select the video type number from the above list. :::selfCfg
  127. GDS %s SELF CONFIGURATION
  128.  
  129. If the machine locks up, reset and try GDS /VESA
  130. :::vBIOSChg
  131.  
  132.  
  133. Attention:  The video BIOS has changed since the file CONFIG was created.
  134. GDS checks the video BIOS to detect new video hardware.  If you are using
  135. a 'smart' extended memory manager (like QEMM), this may happen every time
  136. you start GDS.  You can disable this message by inserting the following
  137. command in the file GDSUSER.CFG:
  138.  
  139.     auto,/OK
  140.  
  141.  
  142. Press [Enter]    to use existing CONFIG file
  143. Press   'R'      to Reconfigure GDS
  144.  
  145. Which? :::selfCfg2
  146. GDS %s SELF CONFIGURATION
  147.  
  148. Video type set to %s
  149.  
  150. Some video cards lock the machine up when asked about VESA support.
  151. Do you want to try to detect VESA support (Y/N)? :::svDet
  152.  
  153. Stealth VRAM detected.  Make sure you have run SMODE MONITOR
  154. Press [Enter] to continue, or [Esc] to exit.:::m32Det
  155.  
  156. ATI MACH 32 detected.  Make sure you have run VVESA to support VESA modes,
  157. and have run the INSTALL utility to configure the Mach 32 for your display.
  158. If you have not done this, you should press [Esc] now and RUN ATI's INSTALL.
  159.  
  160.  
  161. *** IF YOU DO NOT RUN VVESA BEFORE GDS, YOU WILL HAVE NO SVGA MODES! ***
  162.  
  163.  
  164. If you have already configured GDS without VVESA loaded, be sure to delete
  165. the file called 'CONFIG' and re-run GDS.  You may also want to run GDS with
  166. /C0 on the command line to insure that the palette is correct.  The Mach 32
  167. card appears to have palette hardware bugs in 1280x1024x256, although all
  168. other modes appear to work fine and do not require the /C0 parameter.
  169.  
  170. Press [Enter] to continue, or [Esc] to exit.:::m64Det
  171.  
  172. ATI MACH 64 detected.  Make sure you have run INSTALL to configure the card.
  173. Press [Enter] to continue, or [Esc] to exit.:::vDet
  174.  
  175. Viper detected.  Make sure you have run VPRMODE VESA
  176. Press [Enter] to continue, or [Esc] to exit.:::sDet
  177.  
  178. Stealth Pro detected.  Make sure you have run STLMODE VESA
  179. Press [Enter] to continue, or [Esc] to exit.:::s64Det
  180.  
  181. Stealth 64 detected.
  182. Make sure you have S64MODE in your AUTOEXEC.BAT file.
  183. Press [Enter] to continue, or [Esc] to exit.:::noIdea
  184.  
  185.  
  186.                       Oh NO!  /NOIDEA specified!
  187.  
  188.  
  189. If you are having technical problems with GDS, we want to know about it!
  190. Give us a call at (510) 449-9079.  We'll be happy to figure out why things
  191. aren't going well with your copy of GDS.  If you can't get a hold of us
  192. (like if it's Sunday morning at 4:00AM), try sending a FAX.  We'll get back
  193. to you as soon as possible.
  194.  
  195. Photodex Corporation
  196. 1781 Barcelona Street
  197. Livermore, CA  94550
  198.  
  199. (510) 449-9079 - Voice
  200. (510) 449-3519 - FAX
  201.  
  202. Thank you for your support.
  203. :::doDelTxt
  204. It is probably not a good idea
  205. to delete, rename or move the
  206. GDS.TXT file.  Try again.:::falo
  207. WARNING: Files found before /~L%d!  Max files left unchanged.
  208.  
  209. Try specifying the /~L<n> parameter near the top of the GDSUSER.CFG file.
  210.  
  211. Press a key.:::virt
  212. Virtual screen must be 1, 4, 8, 15, 16, or 24 bits
  213. :::noVirt
  214. Can't create virtual file
  215. :::noVidType
  216. Unable to detect video type
  217. :::prob
  218.  
  219. If you have problems configuring GDS, try
  220. giving us a call at (510) 449-9079.
  221. :::detect
  222. Detecting video hardware...:::ckVesa
  223.  
  224. Checking for VESA support...
  225. :::modeTst
  226. VIDEO MODE TEST FOR %s
  227. ───────────────────────────
  228. %s Mode: %dx%d, %ld colors
  229.  
  230. Press: [Enter] to test this graphics mode.
  231.        [Y] to accept mode without testing.
  232.        [N] to remove mode.
  233.  
  234.        [Esc] to cancel.
  235.  
  236. ** If the screen goes crazy, press [Enter] quickly. **:::modeOver
  237. VIDEO CONFIGURATION COMPLETE
  238.  
  239. Press [Enter] to save the configuration
  240. as default, or [Esc] to cancel without
  241. making any changes.:::modeOverwrite
  242. An existing CONFIG file already exists.
  243. Do you want to overwrite it?
  244.  
  245. Press [Y] or [N], or [Esc] to cancel.:::modeNo
  246. Ok.  The changes you have made will not be
  247. saved to the permanent configuration file,
  248. but they will remain active for the rest of
  249. your current GDS session.
  250.  
  251. Press any key to exit.:::palLock
  252.   The palette has been locked to the
  253.  best fit for the currently selected
  254. files.  To unlock the palette, choose
  255.   the 'Lock Palette' option again.
  256.  
  257.      Press any key to continue.:::help
  258. ABOUT GDS/PHOTODEX
  259. GDS %s- Copyright (c)1991-94 Photodex Corporation.  All rights reserved.
  260. ──────────────────────────────────────────────────────────────────────────────
  261.    Photodex Corporation        CompuServe:  74274,3222 (GO GRAPHSUP)
  262.    1781 Barcelona Street         Internet:  photodex@netcom.com
  263.    Livermore, CA  94550
  264.    (510) 449-9079 Voice        Order Line:  (510) 449-9079  9AM-5PM PST
  265.    (510) 449-3519 Fax                        GDS is $39.95 (US funds)
  266. ──────────────────────────────────────────────────────────────────────────────
  267. Usage:    GDS [options] [files]
  268.  
  269.    [options] can be any command line options (see "Help" menu for details.)
  270.              Any command line parameters can be put into a configuration
  271.              file (see "Configuration Options" in the "Help" menu.)
  272.  
  273.      [files] can be any number of file and/or path specifications
  274. ──────────────────────────────────────────────────────────────────────────────
  275. Examples:
  276.           GDS                       -start GDS normally
  277.  
  278.           GDS /S /Z150              -do slideshow with 1.5 second delay
  279.                                      between frames
  280.  
  281.           GDS c:\gifs c:\jpegs      -start GDS using files from the c:\gifs
  282.                                      and c:\jpegs directories:::NoPrt
  283. This GDS trial version does not include printer
  284. drivers to print graphics.  The enhanced versions
  285. print 300dpi graphics fitted to an 8½x11" page in
  286. both portrait and landscape modes.  GDS prints on
  287. HP LaserJet and DeskJet printers, and is known to
  288. work with some true PCL compatible printers.
  289.  
  290.              Photodex
  291. Order Line:  (510) 449-9079   GDS is $39.95
  292.                              VISA/MC/AMEX OK
  293. FAX Orders:  (510) 449-3519
  294.   (please use printed form for FAX orders):::NoShell
  295. This version of GDS does not support shelling to
  296. DOS.  Enhanced versions support shelling.  If you
  297. need the ability to shell to DOS, call us.
  298.  
  299.              Photodex
  300. Order Line:  (510) 449-9079   GDS is $39.95 + s/h
  301.                              VISA/MC/AMEX Ok
  302. FAX Orders:  (510) 449-3519
  303.   (please use printed form for FAX orders):::Free25
  304. This GDS trial version cannot write images which
  305. have been 'color reduced' from more than 8 bits per
  306. pixel.  The enhanced (registered) version of GDS is
  307. responsible for some of the best looking graphics
  308. files in the world, and is available now.
  309.  
  310.              Photodex
  311. Order Line:  (510) 449-9079   GDS is $39.95 + s/h
  312.                              VISA/MC/AMEX Ok
  313. FAX Orders:  (510) 449-3519
  314.   (please use printed form for FAX orders):::NoValConv
  315. No graphics files selected to convert.
  316.  
  317. Put the file cursor on a file, or
  318. select files to convert by using the
  319. mouse or spacebar.:::NoBatch
  320. This GDS trial version cannot handle batch
  321. conversions.  The registered version easily
  322. converts up to 2,700 files in a single batch,
  323. and can do it from the command line as well.
  324. To get these and other powerful features,
  325. you need to call us.
  326.  
  327.              Photodex
  328. Order Line:  (510) 449-9079   GDS is $39.95 + s/h
  329.                              VISA/MC/AMEX Ok
  330. FAX Orders:  (510) 449-3519
  331.   (please use printed form for FAX orders):::NoAdd25
  332. This GDS trial version handles up to 25 files.
  333. The file list already has 25 files, so another
  334. file cannot be added.  The enhanced version
  335. easily handles over 2,700 files in any number
  336. of paths.  To get this function, you should
  337. call us with your order.
  338.  
  339.              Photodex
  340. Order Line:  510-449-9079    GDS is $39.95
  341.                              VISA/MC/AMEX OK
  342. FAX Orders:  510-449-3519
  343.   (please use printed form for FAX orders):::NoReduce
  344. This GDS trial version cannot color reduce true color
  345. (24 bit) pictures, or convert pictures to the JPEG
  346. format.  GDS is responsible for some of the highest
  347. quality 256 color images in the world.  Get GDS,
  348. and get the best color reduction around.
  349.  
  350.              Photodex
  351. Order Line:  (510) 449-9079   GDS is $39.95 + s/h
  352.                              VISA/MC/AMEX Ok
  353. FAX Orders:  (510) 449-3519
  354.   (please use printed form for FAX orders):::conNoV
  355. Unable to create virtual file.
  356.  
  357. (name=%s)
  358.  
  359. Press any key.:::conNoVText
  360. Unable to create virtual file (%s).
  361.  
  362. :::conAb
  363. Aborted by pressing [ESC].
  364.  
  365. Press any key.:::conAbText
  366. Aborted by pressing [ESC].
  367. :::batchFile
  368. You have files selected for a batch
  369. file operation.  This trial version
  370. only processes one file at a time.
  371.  
  372. For more information about getting the
  373. enhanced version of GDS, see "How to
  374. Order GDS" in the "Help" menu.
  375.  
  376. Press any key.:::manDead
  377. :::manMaster
  378. hlConfTop
  379.  hlConfPU
  380.  hlConfInst
  381.  hlConfLaptop
  382.  hlConfVideo
  383.  hlConfRept
  384.  hlConfCrash
  385.  hlConfATI
  386.  hlConfDiamond
  387.  hlConfOrchid
  388.  hlConfTest
  389.  hlConfFile
  390. hlFileList
  391. hlHowToSelect
  392. hlHowToView
  393.  hlViewModeCommands
  394.   hlVMCZoomOMatic
  395.   hlVMCColorLevel
  396.   hlVMCContrast
  397.   hlVMCBrightness
  398.   hlVMCHue
  399.   hlVMCScale
  400.   hlVMCArrow
  401.   hlVMCKeyboardPan
  402.   hlVMCSharp
  403.   hlVMCQuote
  404. hlHowToSlideshow
  405.  hlHowToCLSlideshow
  406. hlHowToCatalog
  407.  hlHowToCLCatalog
  408.  hlBBS
  409. hlHowToConvert
  410.  hlFileConvert
  411.  hlViewWrite
  412.  hl/@C
  413. manMenus
  414.  hlFileMenu
  415.   hlFileMenuCopy
  416.   hlFileMenuMove
  417.   hlFileMenuRename
  418.   hlFileMenuHide
  419.   hlFileMenuDelete
  420.   hlFileMenuSubdirs
  421.   hlFileMenuJump
  422.   hlFileMenuPrint
  423.   hlFileMenuShell
  424.   hlFileMenuExit
  425.  hlViewMenu
  426.   hlViewMenuSlideshow
  427.   hlViewMenuCatalog
  428.   hlViewMenuDithering
  429.   hlViewMenuAntialias
  430.   hlViewMenuBeep
  431.   hlViewMenuComment
  432.   hlViewMenuCatalogStyle
  433.   hlViewMenuCenterSlideshow
  434.  hlDisplayMenu
  435.   hlDisplayMenuShow
  436.   hlDisplayMenuSort
  437.  hlConvMenu
  438.   hlConvBMP1
  439.   hlConvBMP4
  440.   hlConvBMP8
  441.   hlConvBMP24
  442.   hlConvCUT1
  443.   hlConvCUT4
  444.   hlConvCUT8
  445.   hlConvGIF1
  446.   hlConvGIF4
  447.   hlConvGIF8
  448.   hlConvLBM1
  449.   hlConvLBM4
  450.   hlConvLBM8
  451.   hlConvPCX1
  452.   hlConvPCX4
  453.   hlConvPCX8
  454.   hlConvRIX4
  455.   hlConvRIX8
  456.   hlConvTGA15
  457.   hlConvTGA24
  458.   hlConvTIF1
  459.   hlConvTIF4
  460.   hlConvTIF8
  461.   hlConvTIF24
  462.   hlConvJPG24
  463.   hlConvWPG1
  464.   hlConvWPG4
  465.   hlConvWPG8
  466.   hlConvANSI
  467.  hlScanMenu
  468.  hlSetupMenu
  469.   hlSetupMenuConf
  470.   hlSetupMenuSystem
  471.   hlSetupMenuPrintColor
  472.   hlSetupMenuPrintPort
  473.   hlSetupMenuText
  474.  hlHelpMenu
  475.  hlResMenu
  476.  hlAutoLockMenu
  477.  hlMouseMenu
  478.  hlPaletteMenu
  479.   hlLimitPal
  480.   hlFetchPal
  481.   hlLockPal
  482. hlViewModeMenu
  483.  hlViewModeMenuFile
  484.   hlVMMFSaveANS
  485.   hlVMMFSaveGIF
  486.   hlVMMFSaveLBM
  487.   hlVMMFSavePCX
  488.   hlVMMFSaveBMP
  489.   hlVMMFSaveRIX
  490.   hlVMMFSaveTIF
  491.   hlVMMFSaveTGA
  492.   hlVMMFSaveJPG
  493.   hlVMMFSetCrop
  494.   hlVMMFResetCrop
  495.   hlVMMFFileInfo
  496.   hlVMMFQuit
  497.  hlViewModeMenuEdit
  498.   hlVMMERotate
  499.   hlVMMEFlipHorz
  500.   hlVMMEFlipVert
  501.   hlVMMEPan
  502.   hlVMMEReset
  503.  hlViewModeMenuColor
  504.   hlVMMCGray
  505.   hlVMMCMax
  506.   hlVMMCInvert
  507.   hlVMMCResetColor
  508.   hlVMMCResetAll
  509.  hlViewModeMenuSize
  510.   hlVMMSFit
  511.   hlVMMSSetZoom
  512.   hlVMMSDoubleX
  513.   hlVMMSDoubleY
  514.   hlVMMSDoubleXY
  515.   hlVMMSHalfX
  516.   hlVMMSHalfY
  517.   hlVMMSHalfXY
  518.   hlVMMSCenter
  519.   hlVMMSReset
  520.  hlViewModeMenuPrint
  521.   hlVMMPPrint
  522.  hlViewModeMenuRes
  523. manAppendix
  524.  hlTrialVer
  525.   hlDiff
  526.   hlLicensing
  527.  hlViewTheory
  528.  hlCmdAlpha
  529.   hl/!
  530.   hl/A
  531.   hl/B
  532.   hl/C
  533.   hl/D
  534.   hl/E
  535.   hl/F
  536.   hl/G
  537.   hl/H
  538.   hl/I
  539.   hl/I
  540.   hl/K
  541.   hl/L
  542.   hl/LAPTOP
  543.   hl/M
  544.   hl/N
  545.   hl/NOCGA
  546.   hl/NOEGA
  547.   hl/NOHERC
  548.   hl/NOMONO
  549.   hl/NOVESA
  550.   hl/NOIDEA
  551.   hl/O
  552.   hl/OK
  553.   hl/P
  554.   hl/Q
  555.   hl/QUIET
  556.   hl/R
  557.   hl/S
  558.   hl/T
  559.   hl/U
  560.   hl/V
  561.   hl/W
  562.   hl/X
  563.   hl/Z
  564.   hl/#
  565.   hl/=
  566.   hl/~0
  567.   hl/~A
  568.   hl/~B
  569.   hl/~E
  570.   hl/~F
  571.   hl/~G
  572.   hl/~J
  573.   hl/~K
  574.   hl/~L
  575.   hl/~M
  576.   hl/~O
  577.   hl/~R
  578.   hl/~T
  579.   hl/~Z
  580.   hl/<vid>
  581.   hl/512
  582.   hl/1M
  583.   hl@<file>
  584.   hl/@C
  585.  hlCmdVH
  586.  hlRev
  587.  hlGlossary
  588. :::manMenus
  589. Using GDS File List Menus
  590.  
  591. The file display of GDS has pull-down menus at the top of the text screen as
  592. well as the bottom.  The most used menus are at the top and the less
  593. commonly used (and more intricate) menus are at the bottom.
  594.  
  595. To activate a menu, simply click on the menu name with a mouse and drag the
  596. mouse down (or up) until the desired menu option is highlighted).  Release
  597. the mouse button to select the menu option.
  598.  
  599. If you are using a keyboard, you can use an "Alt" key combination to activate
  600. each menu.  Each menu has a highlighted letter, which can be typed as an "Alt"
  601. key combination to activate the menu.  Use the arrow keys to move the
  602. selection bar up and down until the desired option is highlighted.  Press the
  603. [Enter] key to select the menu option.
  604. :::manAppendix
  605. APPENDICES
  606. :::helpTop
  607. GDS Hypertext Help System
  608.  
  609.   Quick Reference
  610.   hlHowToViewHow to View Images        Welcome to GDS's built-in hypertext help
  611.   hlHowToSlideshowHow to Play Slideshows    system.  Use the [Tab] and [Shift-Tab] keys
  612.   hlHowToCatalogHow to Create Catalogs    or the mouse to highlight words and phrases
  613.   hlHowToConvertHow to Convert Images        displayed in bright white.
  614.   hlTrialVerGDS Trial Version
  615.                 For instructions on how to use this help
  616.   Detailed Information        system, press the hlHelpF1] key or hlHelpclick here.
  617.   hlFileListHow the File List Works
  618.   hlHowToSelectHow to Select Files
  619.   hlViewTheoryHow GDS Processes Images
  620.   hlConfTopGDS Configuration Info        Other Information
  621.                     hlFormatsSupported Formats
  622.   Menus & Commands            hlLicensingCD-ROM Licensing Info.
  623.   hlMenusMain File Menus            hlLegalCopyright and Legal Info.
  624.   hlViewModeMenuView Mode Menus            hlPhotodexPhotodex Corporation
  625.   hlViewModeCommandsView Mode Commands            hlOrderOrdering GDS
  626.                     hlOFrmOrder Form
  627.   Lists and Tables            hlUpgradeGDS Upgrades
  628.   hlCmdTopCommand Line Parameters
  629.   hlRevGDS Revision History            hlASPASP Ombudsman Statement (READ THIS!)
  630.   hlGlossaryGlossary of Computer Terms
  631. :::hlASP
  632. Photodex ASP Membership
  633.  
  634. hlPhotodexPhotodex Corporation is a member of the Association of Shareware
  635. Professionals (ASP).  ASP wants to make sure that the shareware principle
  636. works for you.  If you are unable to resolve a shareware-related problem
  637. with an ASP member by hlPhotodexcontacting the member directly, ASP may be able to
  638. help.  The ASP Ombudsman can help you resolve a dispute or problem with an
  639. ASP member, but does not provide technical support for members' products.
  640. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI
  641. 49442-9427 USA, FAX 616-788-2765 or send a CompuServe message via CompuServe
  642. Mail to ASP Ombudsman 70007,3536.
  643. :::hlDistrib
  644. GDS Worldwide Distributors
  645.  
  646. United States        Photodex Corporation        (510)449-9079 - Voice
  647.             1781 Barcelona St.        (510)449-3519 - FAX
  648.             Livermore, CA  94550        photodex@netcom.com
  649.  
  650.  
  651. Distributor Inquiries Welcome; be prepared to FAX corporate backgrounder.
  652. :::hlLicensing
  653. GDS for CD-ROM (View-CD) Licensing Information
  654.  
  655. Special versions of GDS are available for licensing directly from hlPhotodexPhotodex.
  656. If you are a CD-ROM publisher, or would like to include GDS on a CD-ROM
  657. product of any kind, please contact Photodex and ask for the GDS for CD-ROM
  658. licensing information package.  It is about ten pages long, includes all
  659. relevant information about what it is, how it works, instructions on
  660. implementation, and a complete copy of the licensing agreement and terms.
  661. The fastest way to get this information is via FAX.
  662.  
  663. Briefly, the CD-ROM version of GDS is a fully functional standard registered
  664. version of GDS which requires the manufacturer's CD-ROM to be loaded in order
  665. to run.  All GDS for CD-ROM end-users are given the option to register a
  666. standard version since GDS is shareware.
  667.  
  668. If you are a CD-ROM publisher, GDS is the best of both worlds.
  669.  
  670. See Also
  671.     hlPhotodexContacting Photodex
  672.     hlLegalLegal Information
  673.  
  674. :::hlLegal
  675. Copyright and Legal Information
  676.  
  677. Copyright (c)1991-95 Photodex Corporation.  All rights reserved.
  678.  
  679. The GDS program, overlay files, help files, documentation, configuration
  680. files, graphics files and all other files are the property of Photodex
  681. Corporation.
  682.  
  683. If you have the shareware hlTrialVertrial version, you can use the product for a
  684. reasonable trial period of up to 21 days, after which time you must not use
  685. GDS unless you have purchased an enhanced version.
  686.  
  687. Related Topics
  688.     hlTrialVerGDS Trial Version
  689.     hlOrderOrdering GDS
  690.     hlLicensingGDS for CD-ROM Licensing
  691.     hlPhotodexPhotodex Corporation
  692.  
  693. :::hlFileList
  694. Using GDS File List
  695.  
  696. The center section of the screen is the File List.  The first items in the
  697. File List are normally the directories that can be reached from the current
  698. directory.  Directories are noted by the name being enclosed in pointed
  699. brackets: <dir> The parent directory is: <..>.  The current directory is not
  700. listed.  In some cases directories may not appear in the File List.  If you
  701. start GDS with a number of paths specified on the command line GDS will not
  702. display the directory tree in the File List.
  703.  
  704. After the directories GDS lists graphics files in the current directory (or
  705. specified path) that can be displayed.  Double click on a filename to enter
  706. View Mode and display the image.
  707.  
  708. The file display of GDS has pull-down menus at the top of the text screen as
  709. well as the bottom.  The most used menus are at the top and the less
  710. commonly used (and more intricate) menus are at the bottom.
  711.  
  712. To activate a menu, simply click on the menu name with a mouse and drag the
  713. mouse down (or up) until the desired menu option is highlighted).  Release
  714. the mouse button to select the menu option.
  715.  
  716. If you are using a keyboard, you can use an "Alt" key combination to activate
  717. each menu.  Each menu has a highlighted letter, which can be typed as an "Alt"
  718. key combination to activate the menu.  Use the arrow keys to move the
  719. selection bar up and down until the desired option is highlighted.  Press the
  720. [Enter] key to select the menu option.
  721.  
  722. Related Topics
  723.     hlHowToSelectSelecting Files
  724.     hlMenusMain File MenusmanMenus 
  725.  
  726. :::hlUpgrade
  727. GDS Upgrades
  728.  
  729. Special upgrade pricing is available for all registered GDS users.
  730.  
  731. Upgrade
  732.  Price        If you purchased GDS...
  733. -------        -----------------------
  734. $29.95+s/h    ...1.XX
  735.  
  736. $10.00        ...2.XX within the last calandar year.
  737. $29.95+s/h    ...2.XX more than one year ago.
  738.  
  739. $10.00        ...3.XX within the last six months.
  740. $29.95+s/h    ...3.XX within the last six months.
  741.  
  742. (call)        ...any version of GDS Professional
  743.  
  744. Shipping/handling charges are $3.00 for First Class Mail within the
  745. continental United States.  Other shipping charges apply for ALL OTHER
  746. SHIPPING DESTINATIONS.  For specific shipping prices, please call
  747. hlPhotodexPhotodex at (510) 449-9079.
  748.  
  749. $10.00 upgrade prices include First Class Mail within the continental
  750. United States.  Other shipping charges apply for other destinations.
  751. Please call for exact shipping amounts.
  752.  
  753.  
  754. :::hlOrder
  755. How to Order GDS
  756.  
  757. If you have already purchased a copy of GDS, you are eligible to receive
  758. special upgrade pricing.  See hlUpgradeGDS Upgrades.
  759.  
  760. By ordering GDS you get an enhanced version on 3.5" disk, a brief manual, the
  761. right to use GDS as much as you want, and special low upgrade rates for
  762. future versions of GDS.
  763.  
  764. To order GDS with a VISA, MasterCard or American Express, just call hlPhotodexPhotodex
  765. at (510) 449-9079 and have your card number handy.
  766.  
  767. The standard user version of GDS costs $39.95 plus shipping/handling and
  768. California state tax (if you are within California).
  769.  
  770. NOTE: We use your FULL NAME and VOICE PHONE NUMBER as your customer ID.  Your
  771. name and number will appear in your copy of GDS, but will NOT be used for any
  772. other purpose.  THERE ARE NO EXCEPTIONS.
  773.  
  774. To order GDS via mail or FAX, print out the hlOFrmPurchase Order/Registration Form
  775. and fill it out.  If ordering by FAX, please FAX the completed order form
  776. including the appropriate shipping amounts to hlPhotodex(510) 449-3519 -- no cover page
  777. is necessary.
  778.  
  779. If you prefer mailing, put the order form in a stamped envelope including a
  780. check or money order made payable to hlPhotodexPhotodex, and mail to hlPhotodexPhotodex:
  781.  
  782.       Photodex Corporation
  783.       1781 Barcelona Street
  784.       Livermore, CA  94550
  785.  
  786. Orders are usually processed within one business day except major holidays.
  787. UPS Ground shipping or mail is included.  Expedited and international shipping
  788. is extra.  Check orders must be drawn on a United States bank in U.S. funds.
  789. Orders received without proper international shipping charges will be returned
  790. postage due.
  791.  
  792. IF YOU ARE NOT IN THE UNITED STATES:  Call, FAX, E-Mail or write us to find
  793. out what you should be charged for shipping.  If the shipping amount is not
  794. correct on your order, your order will be returned postage due.
  795.  
  796.  
  797. :::hlPhotodex
  798. Photodex Corporation Information
  799.  
  800. Photodex has been a software developer and publisher since 1987.  The
  801. information in this section is subject to change without notice.
  802. 
  803. Address:
  804.     Photodex Corporation
  805.     1781 Barcelona Street
  806.     Livermore, CA  94550
  807.  
  808. Phones:
  809.     Voice    (510) 449-9079    (order line)
  810.     FAX    (510) 449-3519
  811.  
  812. E-Mail:
  813.     Internet    photodex@netcom.com
  814.     CompuServe    74274,3222
  815.     America Online    Photodex
  816.     Prodigy        Photodex
  817. :::hlAbout
  818. About GDS
  819.  
  820. GDS - Copyright(c)1991-95 hlPhotodexPhotodex Corporation.  All rights reserved.
  821.  
  822. GDS is a file viewer and cataloger.  It helps you manage image files.  It
  823. is "ShareWare", not "FreeWare", which means you must pay for it if you
  824. want to keep using it.  When you buy GDS, you also get the right to use it
  825. for as long as you like, a printed manual, several enhanced features, and
  826. the option to upgrade to future releases at greatly reduced rates.
  827.  
  828. See also
  829.     helpTopHypertext Help
  830.     hlOrderOrdering GDS
  831.  
  832.  
  833. :::hlExmp
  834. Example of Hyptertext Link
  835.  
  836. This reference is an example of the hypertext linking in GDS's on-line
  837. Hypertext Reference.  Any time you see a highlighted word, you can click on
  838. it to get more information.
  839.  
  840. Press the [Esc] key on the keyboard to exit back to the previous screen.
  841.  
  842.  
  843. :::hlCmdTop
  844. Command Line Parameters
  845.  
  846.   hlCmdAlphaAlphabetical List
  847.   hlCmdVHSpecifying Video Hardware
  848.   hlCmdCatCatalog Parameters
  849.  
  850.  
  851. :::hlCmdCat
  852. Catalog Parameters
  853.  
  854. The following is a list of command line parameters which are especially
  855. useful for creating catalogs from the command line.  If you wish to fully
  856. understand the capabilities of GDS's command line catalogs, look through
  857. these command line parameters.
  858.  
  859.     hl/A/A    Antialiasing level
  860.     hl/D/D    Dithering level
  861.     hl/G/G    Graphics resolution
  862.     hl/L/L    Catalog label control
  863.     hl/M/M    Optimized palette color limit
  864.     hl/N/N    New file name template
  865.     hl/O/O    Sort yes/no switch
  866.     hl/P/P    Set number of thumbnails across/start auto catalog
  867.     hl/Q/Q    Catalog logo placement control
  868.     hl/U/U    Catalog border control
  869.     hl/W/W    Set first file number to write
  870.     hl/~A/~A    Set catalog style
  871.     hl/~G/~G    Force optimized grayscale palettes
  872.     hl/~M/~M    Set JPEG quality level
  873.     hl/~O/~O    Set file sort type
  874.     hl/~R/~R    Force 1:1 aspect ratio
  875.     hl/~T/~T    Set catalog output file format
  876.     hl@<file>@<file>    Read file list from file
  877.  
  878. Related Topics
  879.     hlHowToCLCatalogCatalogs from the Command Line
  880.     hlBBSCataloging a BBS
  881.  
  882. :::hlCmdVH
  883. Video Hardware Parameters
  884.  
  885. The following is a list of valid video hardware types to be used to force
  886. GDS to assume it has certain video hardware.  See hl/<vid>/<vid>.
  887. 
  888.  /AHEAD        Ahead Systems 'A' chipset
  889.  /AHEADB    Ahead Systems 'B' chipset
  890.  /ATI        ATI VGA Wonder
  891.  /CGA        CGA
  892.  /CHIPS        Early Chips & Technologies chipsets
  893.  /CIRRUS    Early Cirrus Logic chipsets
  894.  /CL54        Cirrus Logic 54xx chipsets
  895.  /EGA        Standard EGA
  896.  /EVEREX    Early Everex SVGA's
  897.  /EV634        Everex Viewpoint Premium VGA
  898.  /F1280        Orchid Farenheit 1280
  899.  /GENOA        Genoa 6600 series (6100, 6200, 6300, 6400, 6600)
  900.  /HERC        Hercules mono only
  901.  /OAK        Oak Technologies
  902.  /PARA        Paradise (Western Digital) chipsets
  903.  /SS24X        Diamond Speedstar 24X (NOT Speedstar 24!)
  904.  /ST64        Diamond Stealth 64
  905.  /STEALTH    Diamond Stealth VRAM
  906.  /STPRO        Diamond Stealth PRO
  907.  /TRIDNT    Trident TVGA / ATI Prism Elite
  908.  /TSENG        Tseng Laboratories ET-3000 chipsets
  909.  /TSENG4    Tseng Laboratories ET-4000 chipsets
  910.  /VESA        VESA (avoids autodetection)
  911.  /VGA        Standard VGA
  912.  /VID7        Video 7 VEGA Deluxe, 1024i, VRAM VGA
  913.  
  914. Related Parameters
  915.     hl/<vid>/<vid>    Force Video Hardware Type
  916.     hl/LAPTOP/LAPTOP    Use on some laptops to avoid standard modes
  917.     hl/NOCGA/NOCGA    Ignore CGA modes (useful for laptops/notebooks)
  918.     hl/NOEGA/NOEGA    Ignore EGA modes (useful for laptops/notebooks)
  919.     hl/NOHERC/NOHERC    Ignore Hercules mono (useful for laptops/notebooks)
  920.     hl/NOMONO/NOMONO    Ignore all mono modes (restricts modes to color)
  921.     hl/NOVESA/NOVESA    Do NOT trust manufacturer's VESA BIOS information
  922.  
  923.  
  924. :::hlCmdAlpha
  925. Alphabetical Command Line Parameter List
  926.  
  927.     *NOTE:  Command line parameters to specify video hardware are not
  928.         shown here. See hlCmdVH/<vid> for more information.
  929. 
  930. hl/! /!     Beep when image view complete
  931. hl/A /A     Antialiasing level
  932. hl/B /B     Text mouse cursor mode
  933. hl/C /C     Palette DAC chip control (SuperEGA's may need this)
  934. hl/D /D     Dithering level
  935. hl/E /E     Image fit mode
  936. hl/F /F     Default file display options
  937. hl/G /G     Default graphics resolution
  938. hl/H /H     Help
  939. hl/I /I     Interlaced GIF fill mode
  940. hl/K /K     Display GIF comments after view
  941. hl/L /L     Catalog label control
  942. hl/LAPTOP /LAPTOP Use on some laptops to avoid certain video modes
  943. hl/M /M     Optimized palette color limit
  944. hl/N /N     New file name template
  945. hl/NOCGA /NOCGA     Ignore CGA modes
  946. hl/NOEGA /NOEGA     Ignore EGA modes
  947. hl/NOHERC /NOHERC Ignore Hercules mono mode
  948. hl/NOMONO /NOMONO Ignore all mono modes
  949. hl/NOVESA /NOVESA Do NOT trust manufacturer's VESA BIOS information
  950. hl/NOIDEA /NOIDEA Prints phone number to call when you're confused
  951. hl/O /O     Sort order control
  952. hl/OK /OK     Prevent recurring configuration
  953. hl/P /P     Create catalogs from command line
  954. hl/Q /Q     Catalog logo placement control
  955. hl/QUIET /QUIET     Disable opening screen
  956. hl/R /R     Resolution 'Lock' mode
  957. hl/S /S     Play slideshow
  958. hl/T /T     Text mode control
  959. hl/U /U     Catalog border control
  960. hl/V /V     File list vertical presentation option
  961. hl/W /W     Set first file number to write
  962. hl/X /X     Exit to DOS after slideshow
  963. hl/Z /Z     Slideshow delay
  964. hl/# /#     Set printer's filename
  965. hl/@C /@C     Convert files from command line
  966. hl/= /=     Control default palette gamma/process levels
  967. hl/~0 /~0     Force screen clear when setting video modes
  968. hl/~A /~A     Set catalog background style
  969. hl/~B /~B     Set slideshow centering mode
  970. hl/~E /~E     Disable slideshow mode change for similar modes
  971. hl/~F /~F     Color reduction proximity elimination level
  972. hl/~G /~G     Force optimized grayscale palettes
  973. hl/~J /~J     Print in color
  974. hl/~L /~L     Set dynamic file list cache size
  975. hl/~M /~M     Set JPEG quality level
  976. hl/~O /~O     Set file sort mode
  977. hl/~R /~R     Assume aspect ratio of all catalog files to 1:1
  978. hl/~T /~T     Catalog output format control
  979. hl/~Z /~Z     Catalog output path control
  980. hl/<vid>/<vid>    Force Video Hardware Type
  981. hl@<file> @<file> Read file list from file
  982.  
  983.  
  984. :::hlRev
  985. Revision History
  986.  
  987. GDS is updated constantly in response to the changing environment of the
  988. computer industry.  Photodex intends to inform existing users of significant
  989. upgrades to GDS as an ongoing process.
  990.  
  991. This revision history is not intended to be extremely complete, but should
  992. indicate some of the major advances in the GDS functionality.  This list
  993. starts with the most recent revisions and continues backward in time.
  994.  
  995. Items marked with '■' are additions, improvements or changes which are
  996. better or comparable to previous versions.  Items marked with 'X' are known
  997. bugs in the listed version which may have been corrected in later versions.
  998.  
  999. GDS 3.1d - minor release
  1000. ------------------------
  1001. NEW!  ■ Full support for Word Perfect Graphics files hlFormats(.WPG).
  1002.  
  1003. NEW!  ■ Full support for Media Cybernetics (HALO) files hlFormats(.CUT + .PAL).
  1004.  
  1005. NEW!  ■ Added full support for reading 4096 color (12-bit) Amiga HAM files.
  1006.  
  1007. NEW!  ■ Added full support for reading Windows Run-Length Encoded (.RLE)
  1008.     files.
  1009.  
  1010. NEW!  ■ Automatically detects and supports hlConfATIATI Mach 32 and Mach 64 cards.
  1011.  
  1012. NEW!  ■ Added support for 32 bit CMYK JPEG files.  GDS now converts CMYK
  1013.     information internally into RGB on the fly.  These files will appear
  1014.     as 24 bit files in the file list.
  1015.  
  1016. NEW!  ■ Added support for generic text files hlFormats(.TXT).  These files are viewed,
  1017.     converted and cataloged the same as ANSI hlFormats(.ANS) files. (View GDS.TXT
  1018.     in the file list!)
  1019.  
  1020.       ■ Optimized JPEG reader to increase speed and reduce code size.
  1021.  
  1022.       ■ Reduced file limit to 2,729 simultaneous files, increasing effective
  1023.     path limit.  If you do hit a path limit, please call us.
  1024.  
  1025.       ■ Added hl/~0/~0n parameter.  This flag can tell GDS to manually
  1026.     clear the screen when it sets graphics video modes.
  1027.  
  1028.       ■ Fixed bug causing "delete" prompt to stick on the same file when user
  1029.     types 'N'.
  1030.  
  1031. GDS 3.1c - minor release
  1032. ------------------------
  1033. NEW!  ■ ANSI text file support.  ANSI files are emulated as if they were
  1034.     graphics files, except for normal viewing, which is done in the
  1035.     current text mode.  When GDS does slideshows or catalogs, ANSI files
  1036.     are rendered into character mapped graphics files on the fly.  You
  1037.     can view a character mapped graphics rendition of an ANSI file by
  1038.     locking the resolution to a graphics mode and double clicking on the
  1039.     ANSI file in the file list.  Writing to ANSI files is a feature of
  1040.     GDS Professional and is not available in standard versions of GDS.
  1041.     Contact Photodex for more information.
  1042.  
  1043. NEW!  ■ GRASP and .FLI file support -- without previous memory limitations.
  1044.     GDS now flushes itself out to EMS, XMS and/or disk when playing .GL
  1045.     and .FLI files.  Make sure to put GRASPRT.EXE and QUICKFLI.EXE in the
  1046.     GDS directory and GDS will automatically view .GL and .FLI files with
  1047.     a double click.
  1048.  
  1049. NEW!  ■ Integrated hypertext help system (you are using it right now!)
  1050.  
  1051. NEW!  ■ Introduced complete on-line manual.  This first release has 74 pages
  1052.     with 199 separate sub-sections.
  1053.  
  1054. NEW!  ■ Automatically detects and supports Diamond Stealth 64 in all video
  1055.     resolutions.  Added hlCmdVH/ST64 to the available command line parameters,
  1056.     but since the Stealth 64 should remain very detectable, using hlCmdVh/ST64
  1057.     should never be necessary.
  1058.  
  1059. NEW!  ■ Configuration greatly improved.  The configuration process has been
  1060.     changed significantly, and should be capable of detecting modes which
  1061.     earlier versions of the configuration would have automatically
  1062.     rejected.  The operation of the configuration process is the same,
  1063.     except that GDS may support quite a few new video modes.
  1064.  
  1065. NEW!  ■ "DOS Shell" function added to registered version.  GDS swaps out of
  1066.     memory during DOS shell functions, using only a 7K for itself.  This
  1067.     enables you to do just about anything from within GDS.
  1068.  
  1069.       ■ Configuration file tag changed.  This will cause a reconfiguration on
  1070.     all systems, regardless of the state of the video hardware.  The
  1071.     reason for this is the improved video mode support and instant video
  1072.     memory test in this version.
  1073.  
  1074.       ■ Corrected problem deleting batches of files in registered version.
  1075.  
  1076.       ■ Corrected problem writing 16 color TIFF files.
  1077.  
  1078.       ■ Cirrus Logic: Added non-VESA video modes back into GDS.  This allows
  1079.     GDS to support non-VESA Cirrus Logic video BIOS's, even if the VESA
  1080.     support does not work reliably.
  1081.  
  1082.       X Fixed DOS error when logging to drive with unreadable disk.
  1083.  
  1084.       X Fixed memory leak when converting files requiring color reduction.
  1085.  
  1086.       X TIFF tag 321 can crash GDS, believed to be in .TIF files made using
  1087.     software bundled with HP Color ScanJets.  Later versions now ignore
  1088.     tag 321.  Fixed in 3.1d.
  1089.  
  1090.       X Command line batch conversions may not operate properly in registered
  1091.     versions.  This bug could be responsible for system crashes.  Fixed
  1092.     in 3.1d.
  1093.  
  1094.       X Problem with hlViewWrite"hlViewWrite" link in hypertext help and
  1095.     printed manual.  This problem sometimes caused the manual to be
  1096.     unprintable, and may have caused GDS to appear to crash when printing
  1097.     the manual.  Fixed in most versions of 3.1c (maintenance release) and
  1098.     formally released in 3.1d.
  1099.  
  1100.       X Problem with 15 and 16 bit modes exists when using a point-and-shoot
  1101.     catalog to view images.  When returning from selected image, catalog
  1102.     screen may be stretched horizontally.  Fixed in 3.1d.
  1103.  
  1104. GDS 3.1b - minor release
  1105. ------------------------
  1106. NEW!  ■ XMS support added for virtual files.  Virtual file operations are now
  1107.     almost as fast as direct screen functions, but can be done in any
  1108.     output resolution, regardless of the available video hardware.
  1109.  
  1110. NEW!  ■ 3-D style catalog screens possible.  Note that this changes the
  1111.     definition of the hl/~A/~A command line parameter.
  1112.  
  1113.       ■ Corrected problem reading certain grayscale JPEG files.
  1114.  
  1115.       ■ Corrected problem reading certain sized 24 bit images when reducing
  1116.     size.  This fix enables GDS to read files which are up to 3072 pixels
  1117.     wide, which is the same as horizontal PhotoCD resolution images.
  1118.  
  1119.       ■ Introduced undocumented hlVMCQuote"Quote-O-Matic" function into view mode.
  1120.  
  1121.       ■ Removed REGISTER.PRN from GDS in order to keep the size of GDS
  1122.     distribution files down.  REGISTER.PRN was an HP LaserJet version of
  1123.     the registration form.  Please use REGISTER.TXT or the help system to
  1124.     print a generic registration form.
  1125.  
  1126.       ■ Added FILE_ID.DIZ and READ.ME to GDS distribution files.  FILE_ID.DIZ
  1127.     is used by many BBS systems to automatically describe ZIP files.
  1128.  
  1129.       X Some problems with XMS virtual file caching have been reported.  Some
  1130.     file conversions can cause GDS to hang the machine, or cause color
  1131.     artifacts during color reduction.  Fixed in 3.1c.
  1132.  
  1133.       X Photodex has received reports of intermittent color artifacts when
  1134.     converting large batches of JPEG files into GIF format using the
  1135.     normal interface.  This may have been corrected with the XMS virtual
  1136.     file bug fix above.  Please bring any color artifacting to our
  1137.     attention immediately.
  1138.  
  1139. GDS 3.1a - minor release
  1140. ------------------------
  1141.       ■ Fixed problem with JPEG file list handling.  Some problems exist in
  1142.     GDS 3.1 which prevent .JPG files from appearing in the file list.
  1143.  
  1144.       ■ Configuration now allows swapping of the red and blue color bars for
  1145.     24 bit video modes.  When modes are displayed during configuration,
  1146.     the message "[S]wap Red & Blue" is displayed, with a red background
  1147.     behind the word "Red" and a blue background behind the word "Blue",
  1148.     so the user can tell if red and blue need to be swapped.
  1149.  
  1150.       ■ Added skew modification to configuration so video modes which have
  1151.     non-standard screen widths can be manually corrected.  If a video
  1152.     mode is radically skewed but displayed without flicker, then use the
  1153.     left and right arrow keys to try adjusting the skew.
  1154.  
  1155.       X Problems reading certain grayscale JPEG files.  Fixed in v3.1b.
  1156.  
  1157. GDS 3.1  - significant release
  1158. ------------------------------
  1159. NEW!  ■ GDS now reads and writes JPEG files.  Registered versions support a
  1160.     command line parameter to adjust the compression level for writing
  1161.     JPEG files.
  1162. 
  1163.       X Problem deleting batches of files correct in 3.1c.
  1164.  
  1165. GDS 3.0  - MAJOR RELEASE
  1166. ------------------------
  1167. NEW!  ■ Radically improved user interface.  GDS just got simpler and easier
  1168.     to use.
  1169.  
  1170. NEW!  ■ New "View Mode Pull-down Menus" allow switching resolutions without
  1171.     exiting to the file list.
  1172.  
  1173. NEW!  ■ On-line help menu and registration form printout.
  1174.  
  1175. NEW!  ■ GDS is now distributed by Photodex.  Photodex is owned by the author
  1176.     of GDS, and has assumed control of all distribution of GDS.  Please
  1177.     direct your inquiries regarding GDS to:
  1178.  
  1179.         Photodex            (510) 449-9079 - Voice
  1180.         1781 Barcelona Street        (510) 449-3519 - FAX
  1181.         Livermore, CA  94550       photodex@netcom.com - internet
  1182.  
  1183.       ■ Cirrus Logic 54xx chipset video hardware now detected and supported.
  1184.  
  1185.       X Problems writing 16 color TIFF files corrected in v3.1c.
  1186. 
  1187.       X Problems reading large 24 bit images and size reducing corrected in
  1188.     v3.1b.
  1189. 
  1190. *NOTE:    Versions earlier than listed here are not officially tracked by this
  1191.     revision history.  If you have a version of GDS earlier than 3.0,
  1192.     then it is safe to assume that the product has changed so much that
  1193.     it might as well be a different product.
  1194.  
  1195.  
  1196. :::hlGlossary
  1197. Glossary
  1198.  
  1199. "antialiasing"
  1200.     The process of smoothing color values together when an image is
  1201.     resized.  Most graphics viewers do not bother antialiasing images
  1202.     because the code is much easier to write.
  1203.  
  1204. "bit"
  1205.     The smallest element of logic, which is either a 1 or a 0.  Bits are
  1206.     combined together to represent larger numbers, like bytes.
  1207.  
  1208. "bork"
  1209.     A bork (or borking) is when you say something that you weren't
  1210.     supposed to say while logged into an on-line chat system.
  1211.     For Example: "I borked."
  1212.  
  1213. "byte"
  1214.     A set of eight bits which can represent 256 different values.  If used
  1215.     to represent a number which starts at 0 and cannot be less than zero
  1216.     (unsigned), a byte can represent a value from 0 to 255.  If signed, a
  1217.     byte represents a value from -128 to 127.  Characters can be thought
  1218.     of as bytes since each character takes one byte to store without
  1219.     specialized compression.
  1220.  
  1221. "chipset"
  1222.     A set of microchips integrated into a piece of computer hardware
  1223.     which is used to accomplish some standardized task.  Video chipsets
  1224.     are integrated into common video cards in order to generate the video
  1225.     signals required to drive a monitor.  Video card manufacturers rarely
  1226.     design their own chipsets anymore, but instead design their video
  1227.     cards around generalized chipsets available from companies like
  1228.     Cirrus Logic, Oak Technologies, S3, Tseng Laboratories and Weitek.
  1229.     Most of the video detection in GDS is specific to chipset detection
  1230.     rather than video card detection, since the chipset is usually the
  1231.     same across many video cards.
  1232.  
  1233. "color reduction"
  1234.     The process of reducing the number of colors used to display a digital
  1235.     image.  The term "color reduction" is usually used to describe the
  1236.     process used to convert images from 15, 16 or 24 bits per pixel to
  1237.     eight or fewer bits per pixel.  This is usually done because most
  1238.     color computer systems have either 16 or 256 color displays, which
  1239.     provide 4 and 8 bits per pixel, respectively.  GDS uses Photodex's
  1240.     proprietary color reduction technology (developed for the professional
  1241.     photography industry), and produces the best color reduction
  1242.     available.  If you have doubts, please benchmark GDS color reduction
  1243.     against other software and prepare to be surprised.
  1244.  
  1245. "diffusion dither"
  1246.     See "Floyd/Steinberg dither" below.
  1247.  
  1248. "Floyd/Steinberg dither"
  1249.     A method of dithering (developed by Floyd and Steinberg) which
  1250.     approximates midtones over areas of pixels by choosing colors which
  1251.     equal the sum total of the immediate area's color value.  This
  1252.     specific type of dither is used in GDS because it is extremely fast.
  1253.     This dithering method is sometimes referred to as a "diffusion
  1254.     dither", although the term "stochastic dither" is more precise.
  1255.  
  1256. "GDS"
  1257.     This program; acronym for "Graphics Display System."
  1258.  
  1259. "HAM"
  1260.     "Hold and Modify", term used to describe an Amiga display mode which
  1261.     can display up to 4096 colors using only six bits per pixel.  The
  1262.     images are encoded such that 16 preset colors can be specified
  1263.     directly, and other colors must be generated by changing the red,
  1264.     green or blue content of following pixels one at a time.  HAM files
  1265.     are a subset of Electronic Arts' IFF specification.
  1266.  
  1267. "pel"
  1268.     See "pixel".
  1269.  
  1270. "pixel"
  1271.     Dot in a digital image.  The term comes from graphics experts
  1272.     abbreviating the term "picture cell" into this shorter slang term.
  1273.     Also- "pel".
  1274.  
  1275. "stochastic dither"
  1276.     See "Floyd/Steinberg dither" above.
  1277.  
  1278. "thumbnail"
  1279.     A small rendition of a larger graphics image.  GDS creates catalogs
  1280.     by creating arrays of thumbnails which are labeled with the filename
  1281.     and resolution of the original graphics image file.
  1282.  
  1283. "TIGA"
  1284.     A library standard which provides access Texas Instruments 32000 and
  1285.     34000 series graphics co-processors.  TIGA is nearly extinct since
  1286.     the recent release of many of the modern video co-processors.
  1287.  
  1288. "virtual file"
  1289.     A pool of memory or disk storage used to hold a large amount of
  1290.     temporary information.  In GDS, virtual files are used to create
  1291.     "virtual screens," which allow GDS to operate on graphics data even
  1292.     if the data cannot be displayed.  For example, virtual files make it
  1293.     possible for a monochrome machine with no graphics capabilities to
  1294.     perform image file conversions from the command line.
  1295.  
  1296. "virtual screen"
  1297.     A virtual file (see above) which contains data which is thought of
  1298.     as a screen because the data is in the same format as it would appear
  1299.     in memory on a video adapter.
  1300.  
  1301. "VRAM"
  1302.     Video RAM.  VRAM is specialized video RAM which can provide a very
  1303.     fast stream of data to the video output generator and still be used
  1304.     at the same time as if it were normal RAM.  This allows the computer
  1305.     to read and write from the video memory while the graphics image is
  1306.     being output to the monitor with very little performance loss.
  1307.  
  1308.  
  1309. :::hlTrialVer
  1310. GDS Trial Version
  1311.  
  1312. The Trial Version of GDS is Shareware.  It is not free software.  It is
  1313. intended to be used for a trial period of up to 21 days.  This allows users
  1314. to test software for a reasonable time and pay only for what they use.
  1315.  
  1316. The GDS Trial Version may only be distributed in its original form, and at
  1317. no charge for the GDS software itself.  Modifying any of the program files
  1318. without permission from Photodex voids any right to redistribute copies.  The
  1319. Registered Version of GDS may not be redistributed without a written
  1320. distribution agreement with hlPhotodexPhotodex.
  1321.  
  1322. If you have been using the Trial Version for an extended period of time,
  1323. please register your copy today.
  1324.  
  1325. Related Topics
  1326.     hlDiffDifferences in GDS Versions
  1327.     hlOrderOrdering GDS
  1328.     hlOFrmGDS Order Form
  1329.     hlLegalCopyright and Legal Info.
  1330.     hlLicensingGDS for CD-ROM Licensing
  1331.  
  1332.  
  1333. :::hlDiff
  1334. Differences in GDS Versions
  1335.  
  1336. All versions of GDS do most functions that GDS users find valuable.  It is
  1337. somewhat unfair to consider GDS "cripple-ware" if you consider that what it
  1338. does do is more than most graphics viewers and converters do in the complete
  1339. versions.
  1340.  
  1341. The following enhancements are available in registered versions of GDS:
  1342.  
  1343.     hlOrderGDS ($39.95) Enhancements in Registered Version
  1344.     -----------------------------------------------
  1345.     Handles over 2,700 simultaneous files in any number of paths
  1346.     Prints in both color and monochrome (HP PCL compatible 300dpi)
  1347.     Supports batch and command line operation for common functions
  1348.     Writes super high quality 256 color images read from 24 bit images
  1349.     Converts to JPEG Format
  1350.     Complete JPEG Compression Control
  1351.     Provides Shelling to DOS
  1352.  
  1353. In addition, there is a version of GDS for BBS system operators and other
  1354. professionals.  The sysop (or professional) version provides hlScanMenuscanning,
  1355. conversion of any graphics file format into ANSI color text files, and some
  1356. very powerful command line parameters for batch functions including automatic
  1357. logo and automatic text insertion into catalogs.
  1358.  
  1359. Related Topics
  1360.     hlOrderOrdering GDS
  1361.     hlOFrmGDS Order Form
  1362.     hlLegalCopyright and Legal Info.
  1363.     hlTrialVerGDS Trial Version
  1364.  
  1365.  
  1366. :::hlMenus
  1367. Menu Options
  1368.  
  1369. hlFileMenuFile   hlViewMenuView   hlDisplayMenuDisplay   hlConvMenuConvert   hlScanMenuScan:Color   hlSetupMenuSetup   hlHelpMenuHelp
  1370.  
  1371.     Click on the menu you would like help with, or choose from the
  1372.     following list:
  1373.  
  1374.         hlFileMenuFile Menu
  1375.         hlViewMenuView Menu
  1376.         hlDisplayMenuDisplay Menu
  1377.         hlConvMenuConvert Menu
  1378.         hlScanMenuScan Menu (GDS Pro. Only)
  1379.         hlSetupMenuSetup Menu
  1380.         hlHelpMenuHelp Menu
  1381.  
  1382.         hlResMenuResolution Menu
  1383.         hlAutoLockMenuAuto/Lock Toggle Button
  1384.         hlPaletteMenuPalette Menu
  1385.         hlMouseMenuMouse Bits/Boxy Toggle Button
  1386.         hlViewMenuSlideshowQuick Slideshow Button
  1387.  
  1388.  
  1389.                             hlViewMenuSlideshow+-----Click Here----+
  1390.                             hlViewMenuSlideshow+---For Slideshow!--+
  1391. hlResMenuRes:####x###x###   hlAutoLockMenuAuto Selection   hlPaletteMenuPalette   hlMouseMenuMouse:Bits
  1392. :::hlFileMenu
  1393. File Menu
  1394.  
  1395. The following options are available in the File List File Menu:
  1396. 
  1397.     hlFileMenuCopyCopy File(s) to...    Ctrl-C
  1398.     hlFileMenuMoveMove File(s) to...    Ctrl-T
  1399.     hlFileMenuRenameRename File(s)...    Ctrl-R
  1400.     hlFileMenuHideHide File(s)        Ctrl-H
  1401.     hlFileMenuDeleteDelete File(s)        Ctrl-D
  1402.     ------------------------------
  1403.     hlFileMenuSubdirsSearch All Subdirs        
  1404.     hlFileMenuJumpJump to Path...        Ctrl-F
  1405.     ------------------------------
  1406.     hlFileMenuPrintPrint Portrait        
  1407.     hlFileMenuPrintPrint Landscape        
  1408.     ------------------------------
  1409.     hlFileMenuShellDOS Shell        Alt-J or Z
  1410.     ------------------------------
  1411.     hlFileMenuExitExit GDS           Esc
  1412.  
  1413.  
  1414. :::hlFileMenuCopy
  1415. File Menu: Copy Files
  1416.  
  1417. This menu item will copy a file or group of files to a different directory
  1418. while leaving the original files intact. hlHowToSelectSelect a file or group of files
  1419. from the File List and select Copy Files (or hit [Ctrl-C]) to start the
  1420. process. GDS will open a dialog box where the destination path for the
  1421. file(s) must be typed in.
  1422.  
  1423.  
  1424. :::hlFileMenuMove
  1425. File Menu: Move Files
  1426.  
  1427. This menu item will move a file or group of files to a different directory
  1428. and delete the original files. hlHowToSelectSelect a file or group of files from the File
  1429. List and select Move Files (or type [Ctrl-M]) to start the process. GDS will
  1430. open a dialog box where the destination path for the file(s) must be typed.
  1431.  
  1432.  
  1433. :::hlFileMenuRename
  1434. File Menu: Rename Files
  1435.  
  1436. This menu item will allow the name of a file to be changed. hlHowToSelectSelect a file
  1437. then select Rename Files (or type [Ctrl-R]) to start the process. GDS will
  1438. open a dialog box where the new filename must be entered.
  1439.  
  1440.  
  1441. :::hlFileMenuHide
  1442. File Menu: Hide Files
  1443.  
  1444. This menu item will remove a file or group of files from the File List
  1445. without deleting them. hlHowToSelectSelect a file or group of files from the File
  1446. List and select Hide Files (or type [Ctrl-H]) to hide the files. The hidden
  1447. files will not appear in the File List while working in the directory.
  1448.  
  1449.  
  1450. :::hlFileMenuDelete
  1451. File Menu: Delete Files
  1452.  
  1453. This menu item will delete a file or group of files from your drive or disk.
  1454. hlHowToSelectSelect a file or group of files from the File List and select Delete Files
  1455. (or type [Ctrl-D]) to start the process. GDS will open a dialog box for
  1456. confirmation of the Delete process.  Type "Y" to delete the file or "N" to
  1457. cancel the process.  NOTE: If you are deleting a batch of files and you are
  1458. absolutely sure you want them gone you can hold down the "Y" key to speed the
  1459. process.
  1460.  
  1461.  
  1462. :::hlFileMenuSubdirs
  1463. File Menu: Search Subdirectories
  1464.  
  1465. This menu item will start a search for graphics files in all subdirectories
  1466. of the current directory.  All valid files will be added to the File List.
  1467. By selecting this command you can scan an entire hard drive (make sure you
  1468. are in the root directory) or CD-ROM disc. You can easily catalog an entire
  1469. CD-ROM by using this command in conjunction with View Menu: Create Catalog.
  1470.  
  1471.  
  1472. :::hlFileMenuJump
  1473. File Menu: Jump to Path
  1474.  
  1475. Selecting Jump to Path from the File menu will open a window allowing any
  1476. number of paths to be entered. Wildcard characters (*) can be used in the
  1477. filenames but not the paths. Multiple paths can be entered but must be
  1478. separated by spaces.
  1479.  
  1480. This command can be particularly useful for CD-ROM catalogs, for limiting
  1481. file types displayed in the File List, or for adding files from another
  1482. directory to the File List.
  1483.  
  1484.  
  1485. :::hlFileMenuPrint
  1486. File Menu: Print Portrait or Landscape
  1487.  
  1488. These menu options will print the currently hlHowToSelectselected file in either portrait
  1489. (10" tall) or landscape (10" wide) mode on HP LaserJets, DeskJets and 100%
  1490. compatible PCL printer language printers.  Additionally, GDS will print in
  1491. color on the DeskJet 500C, 550C, 560C, and 1200C.  The correct port must be
  1492. selected in the Setup Menu: Printer On... section.
  1493.  
  1494. Note:  Printing graphics is supported in enhanced versions of GDS only.
  1495.  
  1496.  
  1497. :::hlFileMenuShell
  1498. File Menu: DOS Shell
  1499.  
  1500. This menu will exit to a DOS shell while leaving GDS in its current state.
  1501. [Alt-Z] and [Alt-J] will also exit to a DOS Shell. To return to GDS from
  1502. the DOS Shell type "exit".
  1503.  
  1504.  
  1505. :::hlFileMenuExit
  1506. File Menu: Exit GDS
  1507.  
  1508. Exits the fantastic world of GDS and leaves you wanting more!
  1509.  
  1510.  
  1511. :::hlViewMenu
  1512. View Menu
  1513.  
  1514. The following options are available in the File List View Menu:
  1515. 
  1516.     hlViewMenuSlideshowView Slideshow
  1517.     hlViewMenuCatalogCreate Catalog
  1518.     -------------------------
  1519.     hlViewMenuDitheringNo Dithering
  1520.     hlViewMenuDithering:2 Dithering
  1521.     hlViewMenuDithering:4 Dithering
  1522.     -------------------------
  1523.     hlViewMenuAntialiasAntialiasing Enabled
  1524.     hlViewMenuBeepBeep For View Complete
  1525.     hlViewMenuCommentAuto Show Comment Records
  1526.     hlViewMenuCatalogStyleBlack Catalogs
  1527.     hlViewMenuCatalogStyleWhite Catalogs
  1528.     hlViewMenuCatalogStyleGray/3D Catalogs
  1529.     hlViewMenuCenterSlideshowCenter Slideshow Images
  1530.  
  1531.  
  1532. :::hlViewMenuSlideshow
  1533. View Slideshow
  1534.  
  1535. This menu option starts a slideshow of the hlHowToSelectselected files.  If no files
  1536. are selected, a slideshow of all files in the file list is played.  You can
  1537. also start a slideshow by clicking in the rectangle at the lower left of the
  1538. main GDS file list screen labeled "Click here for SlideShow!"
  1539.  
  1540. Related Topics
  1541.     hlHowToSlideshowHow to Play a Slideshow
  1542.     hlHowToCLSlideshowSlideshows from the Command Line
  1543.  
  1544. Related Parameters
  1545.     hl/S/S    Play Slideshow
  1546.     hl/Z/Z    Set default delay between slides
  1547.     hl/E/E    Fit images to screen
  1548.  
  1549.  
  1550. :::hlViewMenuCatalog
  1551. Create Catalog
  1552.  
  1553. Selecting this menu option begins the catalog creation process for all
  1554. hlHowToSelectselected files.  If no files are selected, then all files in the file list
  1555. appear in the catalog.
  1556.  
  1557. Related Topics
  1558.     hlHowToCatalogHow to Create Catalogs
  1559.     hlHowToCLCatalogCatalogs from the Command Line
  1560.     hlBBSCataloging a BBS
  1561.  
  1562. :::hlViewMenuDithering
  1563. Dithering Method
  1564.  
  1565. This set of menu items sets the level of dithering when the number of colors
  1566. is reduced.  The default is 1:4 Dithering - the best available.  There may be
  1567. circumstances when a different level of dithering is preferred.
  1568.  
  1569. To change GDS's default dithering method, add hl/D/D<n> to hlConfFileGDSUSER.CFG.
  1570.  
  1571. Related Parameters
  1572.     hl/D/D    Change default dithering
  1573.  
  1574.  
  1575. :::hlViewMenuAntialias
  1576. Antialiasing
  1577.  
  1578. This menu item will toggle the antialiasing function on or off when
  1579. displaying images.  The default setting is on. NOTE: Horizontal-Only
  1580. antialiasing is available by using the hl/A/A option, but is not available using
  1581. menus from within GDS.
  1582.  
  1583. To change GDS's default antialiasing method, add hl/A/A<n> to hlConfFileGDSUSER.CFG.
  1584.  
  1585. Related Parameters
  1586.     hl/A/A    Change default antialiasing method
  1587.  
  1588.  
  1589. :::hlViewMenuBeep
  1590. Beep for View Complete
  1591.  
  1592. This menu item will toggle the beep on or off when GDS finishes displaying an
  1593. image on the screen.  The default setting is on.
  1594.  
  1595. To change GDS's default beep setting, add hl/!/!<n> to hlConfFileGDSUSER.CFG.
  1596.  
  1597. Related Parameters
  1598.     hl/!/!    Change default beep setting
  1599.  
  1600.  
  1601. :::hlViewMenuComment
  1602. CompuServe GIF89a Comments
  1603.  
  1604. This menu item will toggle automatic display of GIF89a Comments on or off.
  1605. The default state is on (hl/K/K1).
  1606.  
  1607. To change GDS's default "comment show" state, add hl/K/K<n> to hlConfFileGDSUSER.CFG.
  1608.  
  1609. Related Parameters
  1610.     hl/K/K    Change default "comment show" state
  1611.  
  1612.  
  1613. :::hlViewMenuCatalogStyle
  1614. Catalog Background/Style
  1615.  
  1616. These menu items will set the style of GDS catalogs.  Black and gray catalogs
  1617. tend to look better on video monitors, while white catalogs are preferable for
  1618. printed output because they use less toner (or ink).  The default style is
  1619. white backgrounds (hl/~A/~A1).
  1620.  
  1621. To change GDS's default catalog style, hl/~A/~A<n> to
  1622. hlConfFileGDSUSER.CFG.
  1623.  
  1624. Related Parameters
  1625.     hl/~A/~A    Change catalog style
  1626.     hl/U/U    Turn catalog image borders on and off
  1627.     hl/L/L    Turn catalog image labels on and off
  1628.  
  1629.  
  1630. :::hlViewMenuCenterSlideshow
  1631. Center Slideshow Images
  1632.  
  1633. This menu item will toggle centering of slideshow images on or off. When on,
  1634. GDS will center each slideshow image on the screen. When off GDS will place
  1635. upper left corner of the image in the upper left corner of the screen.
  1636.  
  1637. To change GDS's default slideshow centering mode, add hl/~B/~B<n> to
  1638. hlConfFileGDSUSER.CFG.
  1639.  
  1640. Related Parameters
  1641.     hl/~B/~B    Turn slideshow centering on and off
  1642.  
  1643.  
  1644. :::hlDisplayMenu
  1645. Display Menu
  1646.  
  1647. The following options are available in the File List Display Menu:
  1648. 
  1649.     hlDisplayMenuShowShow Extensions
  1650.     hlDisplayMenuShowShow Resolution
  1651.     hlDisplayMenuShowShow Pixel Bit Depth
  1652.     hlDisplayMenuShowShow File Size
  1653.     --------------------
  1654.     hlDisplayMenuSortSort: Name, Extn
  1655.     hlDisplayMenuSortSort: Size, Resl
  1656.     hlDisplayMenuSortSort: Bits, Resl
  1657.     hlDisplayMenuSortSort: Resl, Name
  1658.     hlDisplayMenuSortSort: Extn, Name
  1659.  
  1660. This menu allows you to change the appearance of the File List by toggling
  1661. file information on or off and sorting files in a variety of orders.
  1662.  
  1663.  
  1664. :::hlDisplayMenuShow
  1665. Display Menu: Show Options
  1666.  
  1667. These menu items control which information GDS displays for each file in the
  1668. File List. The information is displayed in the following order:
  1669. 
  1670.         PICTURE .GIF  640x480x256 250k
  1671. 
  1672.          (1)     (2)  (3) (4) (5) (6)
  1673. 
  1674. 
  1675.         (1) Filename
  1676.         (2) Three-character extension denoting file format
  1677.         (3) Width of file (in hlGlossarypixels)
  1678.         (4) Height of file (in pixels)
  1679.         (5) Number of colors in file (32k = 32,768)
  1680.                          (65k = 65,536)
  1681.                          (16M = 16.7 million)
  1682.         (6) File size
  1683. 
  1684. The default setting shows the extension and the file size. To change the
  1685. GDS's defaults, add hl/F/F... to hlConfFileGDSUSER.CFG.
  1686.  
  1687. Related Parameters
  1688.     hl/F/F    Default file display options
  1689.  
  1690.  
  1691. :::hlDisplayMenuSort
  1692. Display Menu: Sort Order Options
  1693.  
  1694. The display menu has five "Sort" options, each of which controls how files
  1695. are sorted in the GDS file list.  By default, GDS sorts filenames first by
  1696. the name of the file, and then the file extension.  You can change this sort
  1697. order at any time by selecting one of the "Sort: ..." options in the
  1698. "Display" menu (or by using the hl/~O/~O command line parameter.)
  1699.  
  1700.    Sort: Name, Extn
  1701.     Sort by the name of the file, and then the extension.  This is the
  1702.     default sort order of GDS.
  1703.  
  1704.  * Sort: Size, Resl
  1705.     Sort by the size of the file, and then the resolution of the file if
  1706.     two or more files have the same size.
  1707.  
  1708.  * Sort: Bits, Resl
  1709.     Sort by the number of bits per pixel, and then by the resolution of
  1710.     each file, followed by the file name and extension.
  1711.  
  1712.  * Sort: Resl, Name
  1713.     Sort by the resolution of each file (horizontal dimension first,
  1714.     followed by vertical), then by the name and extension of each file.
  1715.  
  1716.    Sort: Extn, Name
  1717.     Sort by the extension of the name first, then the name and size of
  1718.     each file.  This option is very useful when doing a lot of file
  1719.     conversions.
  1720. 
  1721.       * These options require GDS to have read the file headers from every
  1722.     file in the file list before the list can be properly sorted.
  1723.     Choosing any of these sort orders may cause a significant delay
  1724.     while GDS is reading through all of the graphics files.
  1725.  
  1726.  
  1727. :::hlConvMenu
  1728. Convert Menu
  1729.  
  1730. File conversions in GDS are most simply done using the Convert Menu.  This
  1731. menu allows you to select an output file format for one or more hlHowToSelectselected
  1732. files.
  1733.  
  1734. The following options are available in the Convert Menu:
  1735. 
  1736.     hlConvBMP1BMP monochrome        hlConvPCX1PCX monochrome        hlConvTIF1TIF monochrome
  1737.     hlConvBMP4BMP 16  colors        hlConvPCX4PCX 16  colors        hlConvTIF4TIF 16  colors
  1738.     hlConvBMP8BMP 256 colors        hlConvPCX8PCX 256 colors        hlConvTIF8TIF 256 colors
  1739.     hlConvBMP24BMP 16M colors        hlConvRIX4RIX 16  colors        hlConvTIF24TIF 16M colors
  1740.     hlConvGIF1GIF monochrome        hlConvRIX8RIX 256 colors        hlConvCut1Halo CUT/PAL Mono.
  1741.     hlConvGIF4GIF 16  colors        hlConvTGA15TGA 32K colors        hlConvCut4Halo CUT/PAL 16
  1742.     hlConvGIF8GIF 256 colors        hlConvTGA24TGA 16M colors        hlConvCut8Halo CUT/PAL 256
  1743.     hlConvLBM1LBM monochrome        hlConvWPG1WPG monochrome        hlConvJPG24JPG 16M colors
  1744.     hlConvLBM4LBM 16  colors        hlConvWPG4WPG 16  colors
  1745.     hlConvLBM8LBM 256 colors        hlConvWPG8WPG 256 colors        hlConvANSIANSI 80x25 txt
  1746.  
  1747. If there is no currently selected file in the file list, GDS assumes that the
  1748. single file that the file cursor is highlighting is to be converted.  If there
  1749. are any files hlHowToSelectselected in the file list, GDS assumes that all hlHowToSelectselected files
  1750. should be converted as a batch.  (Note that only registered versions of GDS
  1751. support batch conversions.)
  1752.  
  1753. When files are converted, GDS tries to name the files with the same file name,
  1754. but with the new extension.  If the extension is the same as the original
  1755. file, or if a file with the same name exists, GDS will follow the same naming
  1756. procedure as for catalog files.  By default this will cause GDS to write files
  1757. called GDS000, GDS001, GDS002, and so on.
  1758.  
  1759. Also note that unregistered versions of GDS do not support conversions which
  1760. would result in a 24 bit to 8 bit color reduction, and do not support
  1761. conversion to JPEG formats.  Conversions to ANSI format supported in the Sysop
  1762. version of GDS (GDS Professional) only.  hlPhotodexCall us for more information.
  1763.  
  1764. Related Parameters
  1765.     hl/@C/@C    Convert files from the command line
  1766.  
  1767.  
  1768. :::hlConvBMP1
  1769. Converting to Monochrome BMP
  1770.  
  1771. This process generates hlGlossaryFloyd/Steinberg dithered monochrome files with black
  1772. and white as the two colors.  GDS does not support conversion to monochrome
  1773. formats with other than black and white as the output colors.
  1774.  
  1775. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1776. then analyzes and dithers down to monochrome data.  BMP output data is not
  1777. compressed, and is written from bottom to top (standard BMP.)
  1778.  
  1779.  
  1780. :::hlConvBMP4
  1781. Converting to 16 Color BMP
  1782.  
  1783. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  1784. optimal palette is used, then the 16 colors chosen will be set to an optimal
  1785. 16 color palette for the image.  If a fixed palette is used, then GDS uses a
  1786. standard Windows 16 color palette and dithers the source image.
  1787.  
  1788. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1789. then analyzes and dithers down to 16 color data, unless it is possible to do a
  1790. direct conversion without modifying the color content at all.  BMP output data
  1791. is not compressed, and is written from bottom to top (standard BMP.)
  1792.  
  1793.  
  1794. :::hlConvBMP8
  1795. Converting to 256 Color BMP
  1796.  
  1797. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  1798. An optimal palette is used regardless of the Fixed/Optimal setting in the
  1799. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  1800. In this case, the image is converted directly with no modification of color
  1801. content.
  1802.  
  1803. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1804. then analyzes and dithers down to 256 color data, unless it is possible to do
  1805. a direct conversion without modifying the color content at all.  BMP output
  1806. data is not compressed, and is written from bottom to top (standard BMP.)
  1807.  
  1808.  
  1809. :::hlConvBMP24
  1810. Converting to 24 Bit Color BMP
  1811.  
  1812. This process generates a 24 bit image from any image.  Since 24 bit data has
  1813. a fixed palette, the Fixed/Optimal flag in the conversion window is ignored.
  1814.  
  1815. GDS normally reads input files into a 24 bit virtual buffer and then writes
  1816. it out without modifying the color content at all.  BMP output data is not
  1817. compressed, and is written from bottom to top (standard BMP.)  Note that 24
  1818. bit BMP files are very large because they are stored as raw 24 bit data.
  1819.  
  1820.  
  1821. :::hlConvGIF1
  1822. Converting to Monochrome GIF
  1823.  
  1824. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  1825. and white as the two colors.  GDS does not support conversion to monochrome
  1826. formats with other than black and white as the output colors.
  1827.  
  1828. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1829. then analyzes and dithers down to monochrome data.  GIF output data is
  1830. compressed and more efficient than most other monochrome image file formats.
  1831.  
  1832. GDS does not write comment records to GIF files.
  1833.  
  1834.  
  1835. :::hlConvGIF4
  1836. Converting to 16 Color GIF
  1837.  
  1838. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  1839. optimal palette is used, then the 16 colors chosen will be set to an optimal
  1840. 16 color palette for the image.  If a fixed palette is used, then GDS
  1841. uses a standard EGA/VGA 16 color palette and dithers the source image.
  1842. Photodex has found that it is often better to convert to a standard EGA fixed
  1843. palette than to try to use an optimized palette, because 16 colors is
  1844. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  1845. well suited for conversion purposes.
  1846.  
  1847. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1848. then analyzes and dithers down to 16 color data, unless it is possible to do a
  1849. direct conversion without modifying the color content at all.  GIF output data
  1850. is compressed and more efficient than most 16 color image file formats.
  1851.  
  1852. GDS does not write comment records to GIF files.
  1853.  
  1854.  
  1855. :::hlConvGIF8
  1856. Converting to 256 Color GIF
  1857.  
  1858. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  1859. An optimal palette is used regardless of the Fixed/Optimal setting in the
  1860. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  1861. In this case, the image is converted directly with no modification of color
  1862. content.
  1863.  
  1864. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1865. then analyzes and dithers down to 256 color data, unless it is possible to do
  1866. a direct conversion without modifying the color content at all.  GIF output
  1867. data is compressed and more efficient than most 256 color image file formats.
  1868.  
  1869. GDS does not write comment records to GIF files.
  1870.  
  1871.  
  1872. :::hlConvLBM1
  1873. Converting to Monochrome LBM/IFF
  1874.  
  1875. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  1876. and white as the two colors.  GDS does not support conversion to monochrome
  1877. formats with other than black and white as the output colors.
  1878.  
  1879. GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
  1880. far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
  1881. an LBM file written with GDS, you will notice this preview in the "Open"
  1882. dialog.
  1883.  
  1884. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1885. then analyzes and dithers down to monochrome data.  IFF output data is
  1886. compressed and more efficient than raw monochrome image file formats, but the
  1887. compression is not as good as GIF or other LZ compression formats.
  1888.  
  1889. NOTE: GDS's IFF code is correct.  There are many programs which write bad
  1890. IFF files, and there are even books available incorrectly describing how IFF
  1891. works.  Be careful to follow Electronic Arts' IFF specifications precisely.
  1892.  
  1893.  
  1894. :::hlConvLBM4
  1895. Converting to 16 Color LBM/IFF
  1896.  
  1897. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  1898. optimal palette is used, then the 16 colors chosen will be set to an optimal
  1899. 16 color palette for the image.  If a fixed palette is used, then GDS
  1900. uses a standard EGA/VGA 16 color palette and dithers the source image.
  1901. Photodex has found that it is often better to convert to a standard EGA fixed
  1902. palette than to try to use an optimized palette, because 16 colors is
  1903. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  1904. well suited for conversion purposes.
  1905.  
  1906. GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
  1907. far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
  1908. an LBM file written with GDS, you will notice this preview in the "Open"
  1909. dialog.
  1910.  
  1911. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1912. then analyzes and dithers down to 16 color data, unless it is possible to do a
  1913. direct conversion without modifying the color content at all.  IFF output data
  1914. is compressed and more efficient than raw 16 color image file formats, but the
  1915. compression is not as good as GIF or other LZ compression formats.
  1916.  
  1917. NOTE: GDS's IFF code is correct.  There are many programs which write bad
  1918. IFF files, and there are even books available incorrectly describing how IFF
  1919. works.  Be careful to follow Electronic Arts' IFF specifications precisely.
  1920.  
  1921.  
  1922. :::hlConvLBM8
  1923. Converting to 256 Color LBM
  1924.  
  1925. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  1926. An optimal palette is used regardless of the Fixed/Optimal setting in the
  1927. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  1928. In this case, the image is converted directly with no modification of color
  1929. content.
  1930.  
  1931. GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
  1932. far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
  1933. an LBM file written with GDS, you will notice this preview in the "Open"
  1934. dialog.
  1935.  
  1936. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1937. then analyzes and dithers down to 256 color data, unless it is possible to do
  1938. a direct conversion without modifying the color content at all.  IFF output
  1939. data is compressed and is supposed to be more efficient than raw 256 color
  1940. image file formats, but falls short because the IFF compression was designed
  1941. for monochrome and 16 color data.  256 color IFF files can sometimes be even
  1942. larger than the raw 256 color data.
  1943.  
  1944. NOTE: GDS's IFF code is correct.  There are many programs which write bad
  1945. IFF files, and there are even books available incorrectly describing how IFF
  1946. works.  Be careful to follow Electronic Arts' IFF specifications precisely.
  1947.  
  1948.  
  1949. :::hlConvPCX1
  1950. Converting to Monochrome PCX
  1951.  
  1952. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  1953. and white as the two colors.  GDS does not support conversion to monochrome
  1954. formats with other than black and white as the output colors.
  1955.  
  1956. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1957. then analyzes and dithers down to monochrome data.  PCX output data is
  1958. compressed and sometimes more efficient than raw monochrome image file
  1959. formats, but the compression is not as good as GIF or other LZ compression
  1960. formats.
  1961.  
  1962.  
  1963. :::hlConvPCX4
  1964. Converting to 16 Color PCX
  1965.  
  1966. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  1967. optimal palette is used, then the 16 colors chosen will be set to an optimal
  1968. 16 color palette for the image.  If a fixed palette is used, then GDS
  1969. uses a standard EGA/VGA 16 color palette and dithers the source image.
  1970. Photodex has found that it is often better to convert to a standard EGA fixed
  1971. palette than to try to use an optimized palette, because 16 colors is
  1972. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  1973. well suited for conversion purposes.
  1974.  
  1975. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1976. then analyzes and dithers down to 16 color data, unless it is possible to do a
  1977. direct conversion without modifying the color content at all.  PCX output data
  1978. is compressed and sometimes more efficient than raw 16 color image file
  1979. formats, but the compression is not as good as GIF or other LZ compression
  1980. formats.
  1981.  
  1982.  
  1983. :::hlConvPCX8
  1984. Converting to 256 Color PCX
  1985.  
  1986. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  1987. An optimal palette is used regardless of the Fixed/Optimal setting in the
  1988. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  1989. In this case, the image is converted directly with no modification of color
  1990. content.
  1991.  
  1992. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  1993. then analyzes and dithers down to 256 color data, unless it is possible to do
  1994. a direct conversion without modifying the color content at all.  256 color
  1995. PCX output data uses an RLE compression method which usually falls apart with
  1996. 256 color files because of dithering.  The only time that 256 color PCX data
  1997. will be smaller than raw image file data is when there are runs of solid
  1998. colors in the 256 color image.
  1999.  
  2000.  
  2001. :::hlConvCUT1
  2002. Converting to Monochrome Halo CUT/PAL
  2003.  
  2004. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  2005. and white as the two colors.  GDS does not support conversion to monochrome
  2006. formats with other than black and white as the output colors.
  2007.  
  2008. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2009. then analyzes and dithers down to monochrome data.  Halo CUT output data is
  2010. only marginally compressed and often less efficient than other common file
  2011. formats.
  2012.  
  2013.  
  2014. :::hlConvCUT4
  2015. Converting to 16 Color Halo CUT/PAL
  2016.  
  2017. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  2018. optimal palette is used, then the 16 colors chosen will be set to an optimal
  2019. 16 color palette for the image.  If a fixed palette is used, then GDS
  2020. uses a standard EGA/VGA 16 color palette and dithers the source image.
  2021. Photodex has found that it is often better to convert to a standard EGA fixed
  2022. palette than to try to use an optimized palette, because 16 colors is
  2023. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  2024. well suited for conversion purposes.
  2025.  
  2026. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2027. then analyzes and dithers down to 16 color data, unless it is possible to do a
  2028. direct conversion without modifying the color content at all.  Haloc CUT
  2029. files are only marginally compressed and often less efficient than other
  2030. common file formats.
  2031.  
  2032.  
  2033. :::hlConvCUT8
  2034. Converting to 256 Color Halo CUT/PAL
  2035.  
  2036. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  2037. An optimal palette is used regardless of the Fixed/Optimal setting in the
  2038. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  2039. In this case, the image is converted directly with no modification of color
  2040. content.
  2041.  
  2042. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2043. then analyzes and dithers down to 256 color data, unless it is possible to do
  2044. a direct conversion without modifying the color content at all.  256 color
  2045. CUT output data uses an RLE compression method which usually falls apart with
  2046. 256 color files because of dithering.  The only time that 256 color CUT data
  2047. will be smaller than raw image file data is when there are runs of solid
  2048. colors in the 256 color image.
  2049.  
  2050.  
  2051. :::hlConvWPG1
  2052. Converting to Monochrome WPG
  2053.  
  2054. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  2055. and white as the two colors.  GDS does not support conversion to monochrome
  2056. formats with other than black and white as the output colors.
  2057.  
  2058. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2059. then analyzes and dithers down to monochrome data.  WPG output data is
  2060. compressed and sometimes more efficient than raw monochrome image file
  2061. formats, but the compression is not as good as GIF or other LZ compression
  2062. formats.
  2063.  
  2064.  
  2065. :::hlConvWPG4
  2066. Converting to 16 Color WPG
  2067.  
  2068. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  2069. optimal palette is used, then the 16 colors chosen will be set to an optimal
  2070. 16 color palette for the image.  If a fixed palette is used, then GDS
  2071. uses a standard EGA/VGA 16 color palette and dithers the source image.
  2072. Photodex has found that it is often better to convert to a standard EGA fixed
  2073. palette than to try to use an optimized palette, because 16 colors is
  2074. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  2075. well suited for conversion purposes.
  2076.  
  2077. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2078. then analyzes and dithers down to 16 color data, unless it is possible to do a
  2079. direct conversion without modifying the color content at all.  WPG output data
  2080. is compressed and sometimes more efficient than raw 16 color image file
  2081. formats, but the compression is not as good as GIF or other LZ compression
  2082. formats.
  2083.  
  2084.  
  2085. :::hlConvWPG8
  2086. Converting to 256 Color WPG
  2087.  
  2088. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  2089. An optimal palette is used regardless of the Fixed/Optimal setting in the
  2090. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  2091. In this case, the image is converted directly with no modification of color
  2092. content.
  2093.  
  2094. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2095. then analyzes and dithers down to 256 color data, unless it is possible to do
  2096. a direct conversion without modifying the color content at all.  256 color
  2097. PCX output data uses an RLE compression method which usually falls apart with
  2098. 256 color files because of dithering.
  2099.  
  2100.  
  2101. :::hlConvRIX4
  2102. Converting to 16 Color ColorRIX
  2103.  
  2104. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  2105. optimal palette is used, then the 16 colors chosen will be set to an optimal
  2106. 16 color palette for the image.  If a fixed palette is used, then GDS
  2107. uses a standard EGA/VGA 16 color palette and dithers the source image.
  2108. Photodex has found that it is often better to convert to a standard EGA fixed
  2109. palette than to try to use an optimized palette, because 16 colors is
  2110. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  2111. well suited for conversion purposes.
  2112.  
  2113. ColorRIX files use no compression.
  2114.  
  2115. ColorRIX files use the file extension to denote the resolution of the file.
  2116. This is a huge problem if the image size is not a standard EGA or VGA file
  2117. size.  Because of this problem, the ColorRIX file format is rarely used.
  2118.  
  2119. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2120. then analyzes and dithers down to 16 color data, unless it is possible to do a
  2121. direct conversion without modifying the color content at all.
  2122.  
  2123. :::hlConvRIX8
  2124. Converting to 256 Color ColorRIX
  2125.  
  2126. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  2127. An optimal palette is used regardless of the Fixed/Optimal setting in the
  2128. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  2129. In this case, the image is converted directly with no modification of color
  2130. content.
  2131.  
  2132. ColorRIX files use no compression.
  2133.  
  2134. ColorRIX files use the file extension to denote the resolution of the file.
  2135. This is a huge problem if the image size is not a standard EGA or VGA file
  2136. size.  Because of this problem, the ColorRIX file format is rarely used.
  2137.  
  2138. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2139. then analyzes and dithers down to 256 color data, unless it is possible to do
  2140. a direct conversion without modifying the color content at all.
  2141. :::hlConvTGA15
  2142. Converting to 32K Color Targa
  2143.  
  2144. This process generates 32,768 color (15 bit) TGA files.  If the source input
  2145. image file is more than 15 bits (16 or 24 bit), then the image is hlGlossaryFloyd-
  2146. hlGlossarySteinberg dithered down to 15 bits, in order to simulate the 24 bit
  2147. data as accurately as possible.  The result is better 15 bit images than most
  2148. common software generates.
  2149.  
  2150. GDS normally reads input files into a 24 bit virtual buffer, which it then
  2151. converts into 15 bit data, unless it is possible to do a direct conversion
  2152. without modifying the color content at all.  TGA files are stored from bottom
  2153. to top.
  2154.  
  2155.  
  2156. :::hlConvTGA24
  2157. Converting to 24 Bit Color Targa
  2158.  
  2159. This process generates 16.7 color (24 bit) TGA files.  If the input data has
  2160. less than 24 bits of color information, the color information is padded out
  2161. to 24 bits.
  2162.  
  2163. GDS normally reads input files into a 24 bit virtual buffer and writes it
  2164. directly out in uncompressed form.  TGA files are stored from bottom to top.
  2165.  
  2166.  
  2167. :::hlConvTIF1
  2168. Converting to Monochrome TIFF
  2169.  
  2170. This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
  2171. and white as the two colors.  GDS does not support conversion to monochrome
  2172. formats with other than black and white as the output colors.
  2173.  
  2174. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2175. then analyzes and dithers down to monochrome data.  TIF output data is
  2176. not compressed, but is compatible with most imaging software.  Compressed
  2177. formats (such as hlGIF1GIF are more space efficient).
  2178.  
  2179.  
  2180. :::hlConvTIF4
  2181. Converting to 16 Color TIF
  2182.  
  2183. This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
  2184. optimal palette is used, then the 16 colors chosen will be set to an optimal
  2185. 16 color palette for the image.  If a fixed palette is used, then GDS
  2186. uses a standard EGA/VGA 16 color palette and dithers the source image.
  2187. Photodex has found that it is often better to convert to a standard EGA fixed
  2188. palette than to try to use an optimized palette, because 16 colors is
  2189. sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
  2190. well suited for conversion purposes.
  2191.  
  2192. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2193. then analyzes and dithers down to 16 color data, unless it is possible to do a
  2194. direct conversion without modifying the color content at all.  TIF output data
  2195. is not compressed, but is compatible with most imaging software.  Compressed
  2196. formats (such as hlGIF4GIF are more space efficient).
  2197.  
  2198.  
  2199. :::hlConvTIF8
  2200. Converting to 256 Color TIF
  2201.  
  2202. This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
  2203. An optimal palette is used regardless of the Fixed/Optimal setting in the
  2204. conversion window, unless the conversion does not require hlGlossarycolor reduction.
  2205. In this case, the image is converted directly with no modification of color
  2206. content.
  2207.  
  2208. GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
  2209. then analyzes and dithers down to 256 color data, unless it is possible to do
  2210. a direct conversion without modifying the color content at all.  TIF output
  2211. data is not compressed, but is compatible with most imaging software.
  2212. Compressed formats (such as hlGIF8GIF are more space efficient).
  2213.  
  2214.  
  2215. :::hlConvTIF24
  2216. Converting to 24 Bit TIFF
  2217.  
  2218. This process generates 16.7 color (24 bit) TIFF files.  If the input data has
  2219. less than 24 bits of color information, the color information is padded out
  2220. to 24 bits.  TIFF compression is not used in the output data stream.
  2221.  
  2222. GDS normally reads input files into a 24 bit virtual buffer and writes it
  2223. directly out in uncompressed form.
  2224.  
  2225.  
  2226. :::hlConvJPG24
  2227. Converting to 24 Bit JPEG/JFIF
  2228.  
  2229. *Note:    The trial version of GDS does not support conversion to JPEG format.
  2230.  
  2231. This process reads input data into a 24 bit virtual screen file and converts
  2232. it into a JPEG format output file confirming to the JFIF file format
  2233. specification.  Because JPEG is a lossy compression mechanism, the output
  2234. file will rarely be exactly the same as the input file, but the differences
  2235. are usually so small that they are very difficult to see.  You can adjust
  2236. the quality level (compression level) by using the hl/~M/~M<n> command line
  2237. parameter.hl/~M
  2238.  
  2239. JPEG compression is best suited for continuous tone (photographic) images,
  2240. and does not do a good job with computer generated images with sharp or high
  2241. contrast (artificial looking) edges.
  2242.  
  2243. JPEG is probably the best thing to happen with 16.7 million color images,
  2244. and should be looked at seriously by professionals in the computer industry
  2245. for most 24 bit imaging applications.
  2246.  
  2247. Special thanks go to the Independent JPEG group for their support of the
  2248. JPEG format through the widespread distribution of their sample source code
  2249. libraries.
  2250.  
  2251.  
  2252. :::hlConvANSI
  2253. Converting to ANSI 16 Color Text
  2254.  
  2255. *Note:    The trial version of GDS does not support conversion to ANSI format.
  2256.     Writing ANSI text files is supported by GDS Professional.  Contact
  2257.     hlPhotodexPhotodex for specific information about GDS Pro.
  2258.  
  2259. This process reads the input image into a virtual buffer and then analyzes it
  2260. to find the best way to represent the image using 79 characters wide and as
  2261. many characters tall as necessary to represent the image.  This process is
  2262. complex and generates a better ANSI image than any other software we have yet
  2263. seen or heard of.
  2264.  
  2265. It is impossible to represent a photographic image very well using ANSI
  2266. because of the huge limitations on color and character cell size.  However,
  2267. GDS has become an important tool to create color ANSI files for BBS system
  2268. operators because it is one of the only programs which offers ANSI export
  2269. capability.
  2270. :::hlScanMenu
  2271. Scan Menu
  2272.  
  2273. The Scan Menu is only available in the Professional version of GDS (GDS
  2274. Pro.)  GDS Pro. supports the following scanners:
  2275. 
  2276.     Epson ES-300C Color Scanner
  2277.     Epson ES-600C Color Scanner
  2278.     Microtek MSF-300G
  2279.     Microtek MSF-300Z
  2280.     Microtek MSF-600G
  2281.     Microtek MSF-600Z
  2282.     Microtek Scanmaker 1850
  2283.     Jovian VIA 320x200 Video Capture Board
  2284.     Jovian SVIA 640x480 Video Capture Board
  2285.  
  2286. If you have one of these devices and are interested in GDS Pro please contact
  2287. Photodex directly at (510) 449-9079 for more information.
  2288.  
  2289.  
  2290. :::hlSetupMenu
  2291. Setup Menu
  2292.  
  2293. The Setup Menu allows you to make minor modifications in your video setup,
  2294. allows you to get the status of GDS, allows you to setup your printer, and
  2295. allows you to alter the default text color scheme.
  2296. 
  2297.     hlSetupMenuConfConfigure Video Modes
  2298.     ------------------------
  2299.     hlSetupMenuSystemSystem Info    [Ctrl-S]
  2300.     ------------------------
  2301.     hlSetupMenuPrintColorPrint In Color
  2302.     hlSetupMenuPrintPortPrinter On PRN
  2303.     hlSetupMenuPrintPortPrinter On LPT1
  2304.     hlSetupMenuPrintPortPrinter On LPT2
  2305.     hlSetupMenuPrintPortPrinter On LPT3
  2306.     ------------------------
  2307.     hlSetupMenuTextText Colors    [Ctrl-P]
  2308.  
  2309. Note:  Printing graphics is supported in enhanced versions of GDS only.
  2310.  
  2311. :::hlSetupMenuConf
  2312. Setup Menu: Reconfiguring Video Modes
  2313.  
  2314. Selecting this menu item will run the automatic configuration for video modes
  2315. that have previously been configured. It allows the removal of modes on the
  2316. system, changing the skew, and flipping RGB order for 24 bit color modes.  It
  2317. will not allow the addition of new video modes, but will allow the omission
  2318. of modes which are not working correctly.
  2319.  
  2320. If a system is improperly configured with less modes than available the only
  2321. way to regain them is to delete the file called CONFIG (with no extension)
  2322. and restart GDS with the proper parameters. This will recreate the CONFIG
  2323. file from scratch.
  2324. :::hlSetupMenuSystem
  2325. Setup Menu: System Information
  2326.  
  2327. Selecting this menu item or pressing [Ctrl-S] will open a window showing
  2328. detailed information about GDS, the hardware, and the current state of the
  2329. system.  If you talk to a Photodex support person, they may ask you to do
  2330. this in order to diagnose any problems.
  2331.  
  2332. Near the top of the display is a block of information containing the version
  2333. number of this copy of GDS, the name and telephone number (registration
  2334. number) of the registered user and the date of registration.
  2335.  
  2336. Below that is a listing of the total and available space on the current
  2337. drive.  GDS will always list the space available on the drive where GDS is
  2338. currently logged. Selecting a valid drive (even if no graphics files are
  2339. available) will display the space on the drive.
  2340.  
  2341. Below the Drive Space is a block showing a number of paths used by GDS.
  2342.  
  2343. Below the path lists is a block showing the current amount of memory GDS has
  2344. to work with. Some GDS functions will reduce the amount of memory available.
  2345. If the amount of DOS System RAM and High DOS RAM start getting low it may be
  2346. a good idea to exit the program and restart it to free up memory.
  2347.  
  2348. Near the bottom of the window GDS lists the current Printer Port, the default
  2349. slideshow image display time and a code for the type of video hardware
  2350. detected by GDS.
  2351.  
  2352.  
  2353. :::hlSetupMenuPrintColor
  2354. Print in Color
  2355.  
  2356. This menu item controls whether or not GDS will attempt to print in color.
  2357. GDS supports color printing on the HP 500C, 550C, 560C, and 1200C. The
  2358. default setting is off.
  2359.  
  2360. To change GDS's default color printing setup, add hl/~J/~J<n> to hlConfFileGDSUSER.CFG.
  2361.  
  2362. Related Parameters
  2363.     hl/~J/~J    Set color or grayscale printing
  2364.     hl/#/#    Configure printer's port
  2365.  
  2366.  
  2367. :::hlSetupMenuPrintPort
  2368. Print to Port
  2369.  
  2370. This set of menu items controls which port GDS sends printing information to.
  2371. Select the port specific to your system. If GDS gives an error message when
  2372. printing is attempted the wrong port may be specified. The default printer
  2373. port is PRN.
  2374.  
  2375. To change the default printer port, add the hl/#/# parameter to hlConfFileGDSUSER.CFG.
  2376.  
  2377. Related Parameters
  2378.     hl/~J/~J    Set color or grayscale printing
  2379.     hl/#/#    Configure printer's port
  2380.  
  2381.  
  2382. :::hlSetupMenuText
  2383. Text Colors
  2384.  
  2385. Selecting this item from the Setup Menu or hitting [Ctrl-P] opens a window
  2386. that allows modification of the colors used on text screens (mainly the File
  2387. List.)  A number of presets are available or the colors can be individually
  2388. modified.  Use the left and right arrow keys to select a color and the
  2389. [F1]-[F6] keys to adjust the RGB value for that color. You can save your
  2390. custom palette as the default by hitting S.
  2391.  
  2392.  
  2393. :::hlHelpMenu
  2394. Help Menu
  2395.  
  2396. The help menu gives you the ability to find out more about GDS.  GDS does so
  2397. much that the help system has become an invaluable part of GDS.
  2398.  
  2399.  
  2400. :::hlResMenu
  2401. Resolution Menu
  2402.  
  2403. This menu will display a complete list of text and graphics modes available
  2404. to GDS. The default resolution is listed on the bottom menu bar. Select the
  2405. desired resolution and it will replace the default in the bottom menu bar.
  2406.  
  2407. The default resolution is the resolution in which GDS catalogs are created.
  2408.  
  2409. *Note:  You can force GDS to use a specific video mode by setting the
  2410.     Auto/Lock Toggle Button into the "Lock" state.  When in this state,
  2411.     GDS will ONLY use the mode listed in the Resolution Menu.
  2412.  
  2413. Text modes can also be changed from the Resolution Menu, but cannot be locked
  2414. using the Auto/Lock Toggle Button.  The available text modes are listed after
  2415. all available graphics modes in the Resolution Menu.
  2416.  
  2417. To change GDS's startup default graphics mode, you can add the hl/G/G option
  2418. to hlConfFileGDSUSER.CFG.
  2419.  
  2420. Related Parameters
  2421.     hl/G/G    Set default graphics mode
  2422.     hl/R/R    Set default Auto/Lock state
  2423.  
  2424.  
  2425. :::hlAutoLockMenu
  2426. Auto/Lock Toggle Button
  2427.  
  2428. This toggle button displays Auto or Lock. In auto mode GDS will attempt
  2429. to choose a display mode that best represents the specific image to be
  2430. displayed. In some cases it is desirable to display only in a specific mode.
  2431. Toggling the Auto/Lock button will force GDS to use the graphics mode
  2432. currently selected from the Resolution Menu. The default setting of the
  2433. Auto/Lock button is Auto.
  2434.  
  2435. To change the default setting of the Auto/Lock toggle button, add hl/R/R<n>
  2436. to hlConfFileGDSUSER.CFG.
  2437.  
  2438. Related Parameters
  2439.     hl/G/G    Set default graphics mode
  2440.     hl/R/R    Set default Auto/Lock state
  2441.  
  2442.  
  2443. :::hlMouseMenu
  2444. Mouse Cursor Style
  2445.  
  2446. Toggling the Mouse Bits/Boxy toggle changes the style of the mouse cursor from
  2447. a bitmapped arrow shape (Bits) to a square (Boxy) style.  Some video cards do
  2448. not support the programmable VGA character set properly, and some distortion
  2449. may appear around the mouse.  You can use this toggle to change the mouse
  2450. cursor into a solid character box.
  2451.  
  2452. Related Parameters
  2453.     hl/B/B    Set default mouse cursor mode
  2454.  
  2455.  
  2456. :::hlPaletteMenu
  2457. Palette Menu
  2458.  
  2459. If you are not familiar with image processing techniques, this menu is
  2460. probably better left alone.  It's functions are very powerful, but can lead
  2461. to a lot of confusion if you have misunderstandings about each function.
  2462.  
  2463. If you are a developer, you may find GDS to be one of the most powerful tools
  2464. you use.
  2465.  
  2466. The Palette Menu name always shows the number of colors to be used in optimal
  2467. palettes (usually 256).  You can change this number by hlLimitPallimiting the palette.
  2468.  
  2469. The Palette Menu is divided into three sections.  Each section serves a unique
  2470. purpose.  These sections are as follows:
  2471.  
  2472.     hlLimitPalLimiting Optimal Palette Colors
  2473.     hlFetchPalGenerating/Fetching Palettes from Image Files
  2474.     hlLockPalLocking/Unlocking the Palette
  2475.  
  2476. Most GDS customers use GDS to view collections of image files and will never
  2477. have a need for these palette functions.  If you are a BBS sysop, or a
  2478. software developer of image related software (who isn't these days!) and you
  2479. have a specific need for these functions, GDS can be very useful.
  2480.  
  2481. If you have other needs related to GDS's abilities, please contact Photodex.
  2482. Our optimized palette generation software has been used in many commercial
  2483. applications through special arrangements.
  2484.  
  2485.  
  2486. :::hlLimitPal
  2487. Limiting Optimal Palette Colors
  2488.  
  2489. GDS can display just about any picture on any video display.  It does this
  2490. through internal palette locking and high speed color translation.  For
  2491. example, if GDS needs to display a 256 color image on a 16 color display,
  2492. it generates a 16 color palette, locks the palette internally, creates the
  2493. necessary tables and then converts the 256 colors into the available 16
  2494. colors on the fly.
  2495.  
  2496. Occasionally, it is necessary to leave space in a palette for palette entries
  2497. which will change or need to be set to specific colors.  You can do this by
  2498. choosing the number of colors in the top of the Palette Menu, or by using the
  2499. hl/M/M Command Line Parameter.
  2500.  
  2501. When one of these top menu items is selected, GDS will limit it's optimal
  2502. palette generation to only the number of specified colors, and leave the
  2503. remaining entries black.  All colors are moved to the top of the palette, in
  2504. other words, they are moved toward the last color in the palette.
  2505.  
  2506. There are other undocumented palette functions (like /~S, /~P, /~4) which can
  2507. help your application.  Photodex does not normally document these command
  2508. line parameters because they are extremely complex.  If you want to know
  2509. how they work, you will need to establish a working arrangement with
  2510. Photodex.  Contact Photodex at (510) 449-9079 for more information.
  2511.  
  2512. Related Topics
  2513.     hlFetchPalGenerating/Fetching Image File Palettes
  2514.     hlLockPalLocking/Unlocking the Palette
  2515.  
  2516.  
  2517. :::hlFetchPal
  2518. Generating/Fetching Image File Palettes
  2519.  
  2520. GDS can create an optimal palette from an arbitrary batch of files.  You can
  2521. do this by selecting one or more files and choosing "Lock Selected/Unlock"
  2522. from the Palette Menu.
  2523.  
  2524. Note that the "Lock Selected/Unlock" option has two purposes.  If the palette
  2525. is not locked, then a palette is created using the selected files.  If the
  2526. palette is locked to something (either through optimal palette generation or
  2527. choosing one of the prefabricated palette options), then GDS simply unlocks
  2528. the palette.
  2529.  
  2530. Once the palette is locked, then GDS will display all pictures using that
  2531. locked palette unless a video mode with more than 8 bits per pixel is used.
  2532. GDS normally chooses the best video mode to display pictures in, and may
  2533. choose a 15, 16 or 24 bit video mode, in which case, the locked palette will
  2534. not be used.  You can avoid this by using the hlAutoLockMenuAuto/Lock Resolution Toggle
  2535. hlAutoLockMenuButton.
  2536.  
  2537. All viewing, hlHowToSlideshowslideshowing, hlHowToCatalogcataloging and hlHowToConvertconversion is subjected to locked
  2538. palettes.  You can use this palette before a hlHowToConvertbatch conversion, for example.
  2539.  
  2540. It is a good idea to remember to unlock a palette (using the "Lock
  2541. Selected/Unlock" option) after you're done with your task.  Things can become
  2542. very confusing when using locked palettes, because it may not be apparent
  2543. that the palette is locked when working with GDS on other things.
  2544.  
  2545. The state of the palette is temporary during each session of GDS, so it is
  2546. not necessary to unlock the palette before you exit.  The next time you run
  2547. GDS, the palette will not be locked.
  2548.  
  2549. Related Parameters
  2550.     hl/M/M    Set Optimal Palette Colors
  2551.  
  2552.  
  2553. :::hlLockPal
  2554. Locking/Unlocking the Palette
  2555.  
  2556. Note: For information about locking the internal GDS palette to an image file,
  2557. see hlFetchPalGenerating/Fetching Image File Palettes.
  2558.  
  2559. GDS has several built-in palettes which can be convenient.  These palettes
  2560. are displayed in the lower part of the Palette Menu:
  2561.  
  2562.     Lock to 5 color RGB    (b&w + red, green, blue)
  2563.     Lock to 8 RGB        (b&w + red, green, blue, cyan, magenta, yellow)
  2564.     Lock to 16 EGA
  2565.     Lock to 16 Windows
  2566.     Lock to 16 RGB
  2567.     Lock to 256 RGB
  2568.     Lock to CMYK Print    (approximation of CMYK paper output)
  2569.  
  2570. When you choose one of these palettes, GDS locks the internal palette to the
  2571. colors in the prefabricated palette.  This means that GDS will only use the
  2572. colors in the locked palette to display pictures (unless the video mode used
  2573. is 15, 16 or 24 bit).
  2574.  
  2575. All viewing, hlHowToSlideshowslideshowing, hlHowToCatalogcataloging and hlHowToConvertconversion is subjected to locked
  2576. palettes.  You can use this palette before a hlHowToConvertbatch conversion, for example.
  2577.  
  2578. To unlock the palette, select "Lock Selected/Unlock" option in the Palette
  2579. menu.  Note that this option has two purposes; see hlFetchPalGenerating/Fetching Image
  2580. hlFetchPalFile Palettes for more information.
  2581.  
  2582.  
  2583. :::hlHowToView
  2584. How To View Images
  2585.  
  2586. GDS has one of the fastest viewing interfaces for image files available.
  2587. Simply double click on a filename with a mouse or press [Enter] with the file
  2588. selected, and GDS displays the file.  To exit the view mode, press [Esc] or
  2589. click the mouse button.
  2590.  
  2591. *Note:    GDS has been tuned to be interruptable in most places.  For example,
  2592.     if the [Esc] key is typed even while an image is being displayed, GDS
  2593.     exits very quickly to the File List screen.
  2594.  
  2595. The view mode is very sophisticated, and a full description of the actual
  2596. capabilities GDS offers would seem very intimidating to the average user.  If
  2597. your goal is to be able to view pictures, then you already know enough to
  2598. have great fun with GDS.  If you want to know everything, read on!
  2599.  
  2600. Related Topics
  2601.     hlViewModeMenuView Mode Menus
  2602.     hlViewModeCommandsView Mode Keyboard Commands
  2603.     hlViewTheoryHow GDS Processes Images
  2604.  
  2605.  
  2606. :::hlViewTheory
  2607. How GDS Processes Images
  2608.  
  2609. Many people call us and say "my pictures look better when GDS displays them".
  2610. At first, we assumed that this was just the strange rantings of loyal users.
  2611. However, after we heard it for the 50th time, we checked it out.  The users
  2612. are absolutely right, but the reasons don't really impress us.  It turns out
  2613. that most other software is just doing less of a job of it.  GDS doesn't
  2614. actually make the graphics look better, it just doesn't make it look worse.
  2615.  
  2616. GDS does a lot to make sure that the content of an image file is rendered to
  2617. the screen as precisely as possible (we think this should be standard.)  It's
  2618. not.  Most other software drops bits in 24 bit data to display 15 and 16 bit
  2619. versions, which destroys the images.  Most viewers do not generate optimized
  2620. palettes in order to display 256 color versions of 24 bit files.  The
  2621. technical discussion that could result out of a comparison of GDS to other
  2622. image processing software could go on for days, so we won't bother.
  2623.  
  2624. If you're not technical, the following brainstorm may appear to be a mass of
  2625. random words that only geeks sitting in front of re-runs of Star Trek would
  2626. utter in a heightened argument about Spock's tools.  If you're technical and
  2627. can understand this, then you're a geek, and ...welcome to the club!  I hope
  2628. this section gives you some insight into the very complex world of GDS guts.
  2629.  
  2630. GDS has a monolithic graphics pipeline with many flags and switches which
  2631. affect the way image data is processed.  All of the factors involved in what
  2632. GDS is attempting to do affect exactly how image information is handled.  The
  2633. reason GDS is so fast is because the slow things (most of it) have been hand
  2634. coded in assembly language (three or more generations of optimization).
  2635. Another reason it is so fast is that about 95% of the usually slow processes
  2636. occur almost exclusively in the default data segment.
  2637.  
  2638. When GDS displays an image (via double click or [Enter] key), GDS first makes
  2639. sure that it can recognize the file, and then decides how the data will be
  2640. processed.  If the source file is 24 bits per pixel but the best screen mode
  2641. available only has 8 bits per pixel, then GDS goes through the histogram
  2642. generation, modified heckbert subdivision algorithm and conversion table
  2643. processes necessary to prepare to convert from 24 bits downward.
  2644.  
  2645. Things like 24 bit sharpening are done at the tail end of the process, while
  2646. things like incoming 15, 16 and 24 bit gamma/contrast/brightness adjustment
  2647. are done in the file format drivers, which are built into the code.  GDS is
  2648. not based on drivers.
  2649.  
  2650. Most of the code does not care if the current operation is happening on a
  2651. physically displayed screen, or if it's happening in a virtual file.  This
  2652. is what drives most of the command line functionality.
  2653.  
  2654. Most command line operations automatically create virtual files (perhaps with
  2655. XMS rather than disk files).  XMS is cached into system RAM when needed, and
  2656. should behave at or better than 95% of the speed of screen images.
  2657.  
  2658.  
  2659. :::hlHowToSlideshow
  2660. How To Play a Slideshow
  2661.  
  2662. 1) Use the mouse or keyboard to hlHowToSelectselect the files you want to show.
  2663.    Notice when you hold down the shift key, you can click
  2664.    on files to toggle their selection state, and you can also drag the
  2665.    mouse to select and deselect ranges.  It's easy to select the exact
  2666.    files you want.
  2667.  
  2668. 2) Click on the box in the lower right corner of the GDS
  2669.    file display area labeled "hlMenusClick Here For Slide Show!", or
  2670.    choose hlViewMenuSlideshowSlideshow from the hlViewMenuView Menu.
  2671.  
  2672. 3) You can change the delay in the slideshow by using the
  2673.    hl/Z/Z<n> option at the command line.
  2674.  
  2675. See Also
  2676.     hlHowToCLSlideshowSlideshows from the Command Line
  2677.     hlViewMenuSlideshowView Slideshow (View Menu Option)
  2678.  
  2679. Related Parameters
  2680.     hl/E/E    Fit images
  2681.     hl/O/O    Set sort options
  2682.     hl/Z/Z    Image delay
  2683.  
  2684.  
  2685. :::hlHowToCLSlideshow
  2686. Slideshows from the Command Line
  2687.  
  2688. Type "GDS hl/S/S" followed by filenames or paths and perhaps some of
  2689. the following options:
  2690. 
  2691.     hl/E/E    Fit images
  2692.     hl/O/O    Set sort options
  2693.     hl/X/X    Exit to DOS after last image
  2694.     hl/Z/Z    Image delay
  2695.  
  2696. Note that these command line options each need a number directly after them
  2697. on the command line.  For more information, see the command line reference.
  2698.  
  2699. For example, to do a slideshow of all of the files in the C:\PICS directory
  2700. with two seconds between the display of each image, use the following
  2701. command line:
  2702. 
  2703.     GDS hl/S/S C:\PICS hl/Z/Z20
  2704.  
  2705. GDS can also be used to simply put a picture on the screen as follows:
  2706. 
  2707.     GDS hl/S/S hl/X/X filename.gif
  2708.  
  2709. See Also
  2710.     hlHowToSlideshowHow to Play a Slideshow
  2711.  
  2712. Related Parameters
  2713.     hl/E/E    Fit images
  2714.     hl/O/O    Set sort options
  2715.     hl/X/X    Exit to DOS after last image
  2716.     hl/Z/Z    Image delay
  2717.  
  2718.  
  2719. :::hlHowToCatalog
  2720. How To Create Catalogs
  2721.  
  2722.  1) hlHowToSelectSelect all files by clicking on the first desired file in the file list
  2723.     and dragging the mouse to the end of the file list.  You can also create
  2724.     a catalog of any combination of files.  You can hold down the <Shift> key
  2725.     while using the mouse to add and subtract files from being selected.
  2726.     Also, if no files are selected, GDS will catalog every listed file.
  2727.  
  2728.  2) Next, select hlViewMenuCatalogCreate Catalog from the hlViewMenuView Menu.  Use the "up" and
  2729.     "down" arrow keys to increase or decrease the number of thumbnails
  2730.     displayed on the screen.
  2731.  
  2732.  3) Make sure the "Borders" and "Labels" options are set as you want them.
  2733.     Type "L" and "B" to change them, or use the mouse and click on the
  2734.     "Labels" and "Borders" buttons.
  2735.  
  2736.  4) Press [Enter] to start generating the catalogs.
  2737.  
  2738.  5) When each screen is complete, press <Alt-W> or <Alt-J> to write the screen
  2739.     out as a GDS catalog .GIF or .JPG file.  GDS names the files sequentially
  2740.     like GDS000, GDS001, GDS002, etc.  To change the default naming scheme,
  2741.     you may use the hl/N/N command line option.
  2742.  
  2743.     *SPECIAL NOTE: If you want to write all remaining catalog screens in one
  2744.      batch, you can use <Ctrl-W> or <Ctrl-J> rather than <Alt-W> or <Alt-J>.
  2745.  
  2746.  6) You can print the catalog image by pressing 'P' at the prompt after each
  2747.     catalog screen is completed.  If you do, GDS prints the catalog image and
  2748.     then returns you to the prompt again, in case you want to save the file or
  2749.     exit.  GDS supports Hewlett Packard LaserJet II, 3, 4 and compatible
  2750.     printers (also see the hl/#/# command line option for printer configuration
  2751.     information; the printer must be configured properly using the hlSetupMenuSetup
  2752.     hlSetupMenuMenu).
  2753.  
  2754.     Note:    Printing graphics is supported in enhanced
  2755.         versions of GDS only.
  2756.  
  2757.  7) You're done.  When you look at the GIF or JPG files, you will be able to
  2758.     click on a picture to see the original, as long as the original file is
  2759.     in the current file list.  You can also use <PgUp> and <PgDn> to move
  2760.     through multiple screen catalogs while viewing the catalogs.
  2761.  
  2762.  NOTE:  There is an arbitrary maximum of 100 "point-and-shoot" thumbnails
  2763.     per catalog screen.  In other words, if your catalog has more than
  2764.     100 thumbnails, only the first 100 will allow you to click on an
  2765.     image and refer to the original.
  2766.  
  2767. Some users like to generate catalogs with a black background, rather than a
  2768. white one.  Other users like the look of the 3D (Gray) catalogs.  White
  2769. backgrounds are the default mode for GDS, and are great for printing.  If
  2770. you need to change the style of the catalog, you can change the style using
  2771. the hlViewMenuView Menu, or one of the command line parameters
  2772. listed below.
  2773.  
  2774. See hlCmdCatCatalog Parameters for list of command line parameters related to
  2775. creating GDS catalogs.
  2776.  
  2777. Related Topics
  2778.     hlBBSCataloging a BBS
  2779.  
  2780.  
  2781. :::hlHowToCLCatalog
  2782. Catalogs from the Command Line
  2783.  
  2784. If you are cataloging large numbers of images, you can use the hl/W/W<n> command
  2785. hl/Wline option to tell GDS to automatically write catalog images.  Here's how it
  2786. works:
  2787. 
  2788.   1) Start GDS with the hl/W/W<n> option.  For example, hl/W/W4 would write the
  2789.      first catalog as GDS004.GIF.  It is alright to use hl/W/W0 if necessary.
  2790. 
  2791.   2) Use GDS to create the first catalog screen (as described above).
  2792. 
  2793.   3) When GDS is done creating the catalog, type <Alt-W> to write the image as
  2794.      a GIF file and continue making catalog screens.  From this point on, GDS
  2795.      will automatically write successive catalog screens to GIF files.
  2796.  
  2797. This process can also be automated from the command line, by using the hl/P/P
  2798. option.  Just specify the path/file specification of the files to be cataloged
  2799. and include the hl/P/P<n> and hl/W/W<n> options.  The hl/P/P option sets the number
  2800. of thumbnails across for the catalog screens.  For example, hl/P/P4 creates
  2801. catalog screens with four thumbnails across, and probably four high.  Note
  2802. that in lower resolutions, it is possible to have the number of thumbnails
  2803. across be INEQUAL to the number of thumbnails high (it's rare.)
  2804.  
  2805. See hlCmdCatCatalog Parameters for list of command line parameters related to creating
  2806. GDS catalogs.
  2807.  
  2808. Related Topics
  2809.     hlBBSCataloging a BBS
  2810.  
  2811.  
  2812. :::hlHowToConvert
  2813. Converting Files
  2814.  
  2815. There are three methods for converting files with GDS:
  2816. 
  2817.     hlConvMenuThe Convert Menu
  2818.     hlFileConvertConverting from the main GDS file list using the menus
  2819.     hlViewWriteWriting out a displayed image while viewing an image
  2820.     hl/@CConverting files from the command line
  2821.  
  2822.  
  2823. :::hlFileConvert
  2824. Converting Files in the File List
  2825.  
  2826. To convert files from the main GDS File List using the menus:
  2827. 
  2828.  1) Select a file or a group of files to convert.  You can select multiple
  2829.     files by clicking and holding the mouse button while dragging the pointer
  2830.     over a number of files.  You can also select multiple ranges by holding
  2831.     down [Shift] while clicking on file names to select or deselect them.
  2832.  
  2833.  2) Pull down the "Convert" menu with the mouse (or type [Alt-C]) and then
  2834.     select the desired type of file.
  2835.  
  2836.  3) GDS will open a dialog box that allows you to ROTATE the image or MIRROR
  2837.     (flip) it vertically or horizontally as it writes out the file.  GDS will
  2838.     attempt to name the file the same as the source but with the new
  2839.     extension.  If the extension is the same, or a file with the name already
  2840.     exists, GDS will name the file GDS<n> where <n> is the next available
  2841.     number, i.e. GDS000, GDS001, GDS002...
  2842. 
  2843. *Note:  The trial version does not support "batch conversions."  It will,
  2844.     however, convert non-color reduced files to all formats except
  2845.     24 bit JPEG format.
  2846.  
  2847.  
  2848. :::hlViewWrite
  2849. Writing Images From View Mode
  2850.  
  2851. To convert files from the view screen (writes displayed image to file):
  2852. 
  2853.  1) (OPTIONAL) To save a portion of the displayed image: move the mouse
  2854.     pointer to the "File" menu and highlight "Set Save Rect".  Release the
  2855.     mouse button.  Move the mouse pointer to one corner of the rectangular
  2856.     area you want to save.  Click and hold the mouse button.  Drag the
  2857.     rectangle that appears to the desired size.  Release the mouse button.
  2858.     Only the area inside the rectangle will be saved by following the
  2859.     remaining steps.  (If you are unhappy with your selection you can return
  2860.     the crop rectangle to include the entire screen by selecting "Reset Crop
  2861.     Rectangle" from the "File" menu.)
  2862.  
  2863.  2) Move the mouse pointer to the top of the view screen; click and hold the
  2864.     mouse button down.  The "View Mode Menu Bar" will appear.
  2865.  
  2866.  3) Move the mouse pointer to the "File" menu.
  2867.  
  2868.  4) Highlight the type of destination file by moving the mouse pointer to it,
  2869.     and release the mouse button to select the format.
  2870.  
  2871.  5) GDS will write the graphics file, and, if successful, open a dialog box
  2872.     so you can rename the file if you like.  If the name GDS picks is
  2873.     acceptable, hit [Enter].  Otherwise change the name and hit [Enter].  GDS
  2874.     displays a warning message if you try to use a name that already exists,
  2875.     and will not overwrite an existing file during the rename function.
  2876.  
  2877.  6) If you are writing the same format as the file you are viewing, GDS
  2878.     displays a small prompt that asks you if you want to overwrite the file.
  2879.     If you choose 'Y' for yes, then GDS will overwrite the file if the image
  2880.     and be successfully written.  If you choose 'N', then GDS will write the
  2881.     file to a file such as GDS000, GDS001, etc.  Choosing 'Esc' at this prompt
  2882.     cancels the write function and no file will be written.
  2883.  
  2884.  
  2885. :::hl/!
  2886. /! Parameter (View Beep)
  2887.  
  2888.  /!<n>  - Enable/disable beep after display of image
  2889.     /!0 - Don't beep
  2890.     /!1 - Beep (default)
  2891. :::hl/A
  2892. /A Parameter (Default Antialiasing Mode)
  2893.  
  2894.  /A<n>  - Antialiasing level
  2895.     /A0 - No antialiasing
  2896.     /A1 - Horizontal antialiasing
  2897.     /A2 - Two dimensional (default)
  2898. :::hl/B
  2899. /B Parameter (Default Mouse Cursor State)
  2900.  
  2901.  /B<n>  - Default mouse mode
  2902.     /B0 - Character mouse pointer
  2903.     /B1 - Bitmapped mouse pointer (default)
  2904. :::hl/C
  2905. /C Parameter (Bits in Color DAC)
  2906.  
  2907.  /C<n>  - Set number of bits in DAC chip (or 0 to use BIOS palette calls)
  2908.     /C0 - Use BIOS ONLY for palette (also kills screen saver)
  2909.     /C6 - Standard VGA DAC (default)
  2910.     /C8 - Cool expensive DAC (8 bits per color bar)
  2911. :::hl/D
  2912. /D Parameter (Default Dithering Mode)
  2913.  
  2914.  /D<n>  - Set default dither mode
  2915.     /D0 - No dithering
  2916.     /D1 - 2x2 two color matrix
  2917.     /D2 - 2x2 four color matrix (default)
  2918. :::hl/E
  2919. /E Parameter (Image/Screen Fit Mode)
  2920.  
  2921.  /E<n>  - Set image/screen fit mode (0=norm, 1=fit)
  2922.     /E0 - Do not fit viewed images to the screen (default)
  2923.     /E1 - Fit all images to the screen
  2924. :::hl/F
  2925. /F Parameter (Default File Display Options)
  2926.  
  2927.  /F#### - Set options for file display
  2928.  
  2929.     Each of the four number signs holds the position of each of the
  2930.     following single character parameters below.  Specify a '1' or a '0'
  2931.     to enable or disable the display of each of these types of data:
  2932.  
  2933.     ■ Extension    ■ Resolution    ■ Bits/Pixel    ■ File Size
  2934.  
  2935.     For example:  /F0110 enables the resolution and bits per pixel, but
  2936.     disables the extension and file size.
  2937. :::hl/G
  2938. /G Parameter (Default Graphics Resolution)
  2939.  
  2940.  /G<X>x<Y>x<B>  - Set default graphics mode:
  2941.         <X> - Horizontal Resolution (pixels wide)
  2942.         <Y> - Vertical Resolution (pixels high)
  2943.         <B> - Number of Colors (or bits per pixel):
  2944.         16 - 16 colors
  2945.         256 - 256 colors
  2946.         32k - 32,768 colors
  2947.         64k - 65,536 colors
  2948.         16M - 16.7 million colors (24 bit)
  2949.  
  2950.     Examples:       /g640x480x256    (640x480 256 colors)
  2951.             /g1024x768x16m    (1024x768 16.7 million colors)
  2952. :::hl/H
  2953. /H Parameter (Display Help)
  2954.  
  2955.  /H /?  - Display help screen (or /?)
  2956. :::hl/I
  2957. /I Parameter (Interlaced Fill Mode)
  2958.  
  2959.  /I<n>  - Set interlaced fill mode for GIF images
  2960.     /I0 - Disable early filled interlaced GIFs (default)
  2961.     /I1 - Enable interlaced filling
  2962. :::hl/K
  2963. /K Parameter (File Comment Mode)
  2964.  
  2965.  /K<n>  - Controls automatic GIF comment display after image read
  2966.     /K0 - Disable comments
  2967.     /K1 - Enable comments
  2968. :::hl/L
  2969. /L Parameter (Catalog Label Switch)
  2970.  
  2971.  /L<n>  - Control Catalog Labeling
  2972.     /L0 - Don't display labels under catalog thumbnails
  2973.     /L1 - Display labels under catalog thumbnails
  2974.     /L2 - Display labels only, centered under thumbnails
  2975. :::hl/LAPTOP
  2976. /LAPTOP Parameter (Avoid Older Video Modes)
  2977.  
  2978.  /LAPTOP- Use on some laptops to avoid older modes.
  2979.             NOTE: This option is the same as using: /NOCGA /NOEGA /NOHERC
  2980. :::hl/M
  2981. /M Parameter (Maximum Optimal Palette Colors)
  2982.  
  2983.  /M<n>  - Maximum colors to use during color reduction
  2984.  
  2985.     *Note:    Use values between 16 and 256 for best results.
  2986. :::hl/N
  2987. /N Parameter (Automatic Filename Template)
  2988.  
  2989.  /N<str>- Set "printf" style template for output files (default="GDS%03d")
  2990.  
  2991.     If you are not familiar with printf() style formatting, refer to a
  2992.     reference text on the 'C' libraries.  In general, the '%03d' holds
  2993.     the place of a three digit number.  You can change anything else in
  2994.     the string, but you cannot add an extension.
  2995.  
  2996.     Examples:    /NABCD%03d    (result="ABCD000")
  2997.             /N%08d        (result="00000000")
  2998.             /N%02d_SAUCE    (result="00_SAUCE")
  2999. :::hl/NOCGA
  3000. /NOCGA Parameter (Avoid CGA Modes)
  3001.  
  3002.  /NOCGA - Ignore CGA modes (useful for laptops/notebooks).
  3003. :::hl/NOEGA
  3004. /NOEGA Parameter (Avoid EGA Modes)
  3005.  
  3006.  /NOEGA - Ignore EGA modes (useful for laptops/notebooks).
  3007. :::hl/NOHERC
  3008. /NOHERC Parameter (Avoid Hercules Mono Mode)
  3009.  
  3010.  /NOHERC- Ignore Hercules monochrome mode (useful for laptops/notebooks).
  3011. :::hl/NOMONO
  3012. /NOMONO Parameter (Avoid Mono Modes)
  3013.  
  3014.  /NOMONO- Ignore all monochrome modes (useful for people who like color).
  3015. :::hl/NOVESA
  3016. /NOVESA Parameter (Don't Trust VESA)
  3017.  
  3018.  /NOVESA- Do NOT trust VESA for mode configuration information.
  3019. :::hl/NOIDEA
  3020. /NOIDEA Parameter (Extra Support)
  3021.  
  3022.  /NOIDEA- Use just before calling technical support.
  3023. :::hl/O
  3024. /O Parameter (Slideshow Sort Flag)
  3025.  
  3026.  /O<n>  - Set sort flag for slideshow
  3027.     /O0 - Don't sort before slideshow
  3028.     /O1 - Sort before slideshow (honors hl/~O/~O setting)
  3029.  
  3030. Related Topics
  3031.     hl/~O/~O    File Sort Mode    
  3032. :::hl/OK
  3033. /OK Parameter (Avoid Video BIOS Check)
  3034.  
  3035.  /OK    - Assume CONFIG file is correct and use it.  Note: this switch avoids
  3036.           GDS's automatic re-configuration of video hardware.  If you have a
  3037.           video card which arbitrarily changes it's own video BIOS contents,
  3038.           then put this switch in your hlConfFileGDSUSER.CFG as follows:
  3039.  
  3040.             auto,/ok     ;assume CONFIG is ok to use
  3041. :::hl/P
  3042. /P Parameter (Generate Catalogs)
  3043.  
  3044.  /P<n>  - Automatically generate catalogs and write them.  <n> determines how
  3045.     many thumbnails will appear across the catalog.  For example, if you
  3046.     need four thumbnails across and down, use the following switch:
  3047.  
  3048.     /P4
  3049.  
  3050.     A special mode has been added which triggers the handy command line
  3051.     catalog interface in GDS:
  3052.  
  3053.     /P?
  3054.  
  3055.     This catalog interface can be used in a BBS if the standard input and
  3056.     output streams are directed to the modem.
  3057.  
  3058. Related Topics
  3059.     hlCmdCatCatalog Parameters
  3060. :::hl/Q
  3061. /Q Parameter (Specify Catalog Logo File)
  3062.  
  3063.  /Q<x>_<y>_<name> Add logo to automatic catalogs (use with hl/P/P<n>)
  3064. :::hl/QUIET
  3065. /QUIET Parameter
  3066.  
  3067.  /QUIET - Prevents GDS from displaying opening screen on startup.
  3068.  
  3069.  
  3070. :::hl/R
  3071. /R Parameter (Set Auto/Lock State)
  3072.  
  3073.  /R<n>  - Set default resolution 'Lock' mode (0=AutO, 1=LOck)
  3074. :::hl/S
  3075. /S Parameter (Play Slideshow)
  3076.  
  3077.  /S     - Slideshow mode (no user interface, just automatic slideshow)
  3078. :::hl/T
  3079. /T Parameter (Set Default Text Mode)
  3080.  
  3081.  /T<h>x<v>  - Set default text mode
  3082.         <h> Horizontal resolution
  3083.         <v> Vertical resolution
  3084.  
  3085.         Example:    GDS /T80x25
  3086. :::hl/U
  3087. /U Parameter (Catalog Borders On/Off)
  3088.  
  3089.  /U<n>  - Control Catalog Borders
  3090.     /U0 - No borders around thumbnails
  3091.     /U1 - Put borders around thumbnails
  3092.  
  3093. Related Topics
  3094.     hlCmdCatCatalog Parameters
  3095. :::hl/V
  3096. /V Parameter (Set Vertical Orientation)
  3097.  
  3098.  /V<n>  - Set vertical orientation file display (0=horiz, 1=vert)
  3099. :::hl/W
  3100. /W Parameter (Set Auto Filename Number)
  3101.  
  3102.  /W<n>  - Automatically write catalogs GDS<n++>.GIF after first screen
  3103. :::hl/X
  3104. /X Parameter (Exit to DOS)
  3105.  
  3106.  /X     - Exit to DOS after displaying image, but leave graphics mode up
  3107. :::hl/Z
  3108. /Z Parameter (Set Slideshow Delay)
  3109.  
  3110.  /Z<n>  - Set slideshow delay in 100ths of seconds: Default is 300 (3 seconds)
  3111. :::hl/#
  3112. /# Parameter (Set Printer Port/Filename)
  3113.  
  3114.  /#<lpt#:> - Set filename of printer device (ie:  /#LPT2 ; default is /#PRN)
  3115.           NOTE: The printer must be configured correctly to avoid the annoying
  3116.           error messages.
  3117. :::hl/=
  3118. /= Parameter (Set Video Palette Processes)
  3119.  
  3120.  /=<bn> - Set default red/green/blue/contrast/brightness/color/sharpness
  3121.             /=R<n> - Default red level (+/- 255)
  3122.             /=G<n> - Default green level
  3123.             /=B<n> - Default blue level
  3124.             /=C<n> - Default contrast (+/- 255)
  3125.             /=+<n> - Default brightness (+/- 255)
  3126.             /=L<n> - Default color level (+/- 255)
  3127.             /=S<n> - Default 24 bit sharpening level (0-10+)
  3128.             /=H<n> - Default hue setting (0-255)
  3129. :::hl/~0
  3130. /~0 Parameter (Always Clear Screen Flag)
  3131.  
  3132.  /~A<n> - Set flag for manually clearing the graphics screen
  3133.  
  3134.     <n> must be one of the following values:
  3135.         0 = Assume the video card will properly clear the screen
  3136.         1 = Don't assume ANYTHING, and always clear the screen
  3137.  
  3138.     Examples:    GDS /~01    Always clear the screen
  3139.             GDS /~00    Trust your video card's BIOS to
  3140.                     clear the screen...
  3141. :::hl/~A
  3142. /~A Parameter (Set Catalog Style)
  3143.  
  3144.  /~A<n> - Set the style of GDS catalogs.
  3145.  
  3146.     <n> must be one of the following values:
  3147.         0 = Black background with tan borders
  3148.         1 = White background with black borders (Default)
  3149.         2 = Gray backgrounds with 3-D looking image borders
  3150.  
  3151.     Example:    GDS /~A2    Default to Gray/3D catalogs
  3152. :::hl/~B
  3153. /~B Parameter (Set Slideshow Centering)
  3154.  
  3155.  /~B<n> - Set automatic centering mode of slideshows.
  3156.  
  3157.     /~B0 - Do not center slideshow images
  3158.     /~B1 - Center slideshow images (default)
  3159. :::hl/~E
  3160. /~E Parameter (Inhibit Slideshow Screen Erasure)
  3161.  
  3162.  /~E<n> - Inhibit slideshow screen erase between similar images
  3163.  
  3164.     /~E0 - Always clear the screen
  3165.     /~E1 - Don't clear the screen unless the video mode changes (faster)
  3166. :::hl/~F
  3167. /~F Parameter (Color Proximity Elimination)
  3168.  
  3169.  /~F<n> - Enable color proximity elimination in color reduction
  3170. :::hl/~G
  3171. /~G Parameter (Optimal Grayscale Palettes)
  3172.  
  3173.  /~G<n> - Generate optimized grayscale palettes (G1, default=G0)
  3174. :::hl/~J
  3175. /~J Parameter (Color Printing)
  3176.  
  3177.  /~J<n> - Print in COLOR.  HP PCL CMY process inkjet printers supported.
  3178.     /~J0 - Support black and white printing only (default)
  3179.     /~J1 - Support CMYK color PCL
  3180.  
  3181. Note:  Printing graphics is supported in enhanced versions of GDS only.
  3182. :::hl/~K
  3183. /~K Parameter
  3184.  
  3185. This option was used in version 3.0 and is no longer needed.
  3186. :::hl/~L
  3187. /~L Parameter (Dynamic File List)
  3188.  
  3189.  /~L<n> - Set initial length of dynamic file list cache size for GDS.  The
  3190.           maximum number of files GDS can handle is 2848.  The default for
  3191.           this option is 200.  You may save a very small amount of RAM by
  3192.           setting this number lower if you use GDS with fewer than 150 files
  3193.           at a time.  Setting this number to 50 will save 3450 bytes of RAM.
  3194.           As the file list grows, GDS may run out of memory, which will stop
  3195.           GDS from adding valid files to the file list.  This should not
  3196.           happen unless GDS is trying to deal with thousands of files. Paths
  3197.           are handled separately and there is no practical limit to the
  3198.           number of concurrent paths GDS can handle.
  3199. :::hl/~M
  3200. /~M Parameter (JPEG Quality)
  3201.  
  3202.  /~M<n> - Set default JPEG quality level
  3203.  
  3204.     Use values between 10 and 99.  Higher values result in better image
  3205.     quality at the expense of compression.
  3206.  
  3207.     /~M75 - Set JPEG Quality to 75 (default)
  3208.  
  3209.     *Note:    Not supported in trial shareware version.
  3210. :::hl/~O
  3211. /~O Parameter (File Sort Mode)
  3212.  
  3213.  /~O<n> - Set default file sort mode (0=name/1=size/2=bits/3=res/4=extn)
  3214. :::hl/~R
  3215. /~R Parameter (Aspect Ratio Handling)
  3216.  
  3217.  /~R<n> - Force aspect ratio of all catalog files to 1:1
  3218. :::hl/~T
  3219. /~T Parameter (Catalog File Output Format)
  3220.  
  3221.  /~TA    - Write to ANSI text (sysop/professional version only).
  3222.  /~TB    - Write to BMP
  3223.  /~TD    - Write to CUT (Dr. Halo)
  3224.  /~TI    - Write to TIFF
  3225.  /~TJ    - Write to JPG (JFIF)
  3226.  /~TL    - Write to LBM
  3227.  /~TP    - Write to PCX
  3228.  /~TR    - Write to RIX
  3229.  /~TT    - Write to TGA
  3230.  /~TW    - Write to GIF (default)
  3231.  /~TY    - Write to WPG
  3232.  
  3233.  
  3234. :::hl/~Z
  3235. /~Z Parameter (Write to Startup Path)
  3236.  
  3237.  /~Z<n> - Always try to write new files to startup path
  3238. :::hl/<vid>
  3239. /<vid> Parameter (Force Video Type)
  3240.  
  3241. This parameter avoids all video hardware autodetection and forces GDS to
  3242. assume that there is a certain type of video hardware available.  For more
  3243. information, see hlCmdVHVideo Hardware Parameters.
  3244. :::hl/512
  3245. /512 Parameter
  3246.  
  3247. This parameter forced older versions of GDS to assume that the video hardware
  3248. had at least 512K of video RAM.  This option is now obsolete because the
  3249. automatic configuration reliably detects the validity of individual modes,
  3250. including the availability of sufficient video RAM.
  3251. :::hl/1M
  3252. /1M Parameter
  3253.  
  3254. This parameter forced older versions of GDS to assume that the video hardware
  3255. had at least one megabyte of video RAM.  This option is now obsolete because
  3256. the automatic configuration reliably detects the validity of individual modes,
  3257. including the availability of sufficient video RAM.
  3258. :::hl@<file>
  3259. @<file> Parameter (Read File Spec. List)
  3260.  
  3261.  @<file> - Read file list from text file: <file>  (ie:  GDS @file.lst )
  3262. :::hl/@C
  3263. /@C Parameter (Convert Files)
  3264.  
  3265. GDS can perform all file conversion operations from the command line.  GDS
  3266. uses either XMS or disk space as a virtual file, so the resolution of the file
  3267. is not important.  This makes GDS ideal for use with on-line systems as a
  3268. simple means of providing multiple file formats for download.
  3269.  
  3270. The /@C command line parameter can be used to carry out a single conversion or
  3271. a batch conversion.  Any files which are specified to GDS are assumed to be
  3272. converted into the specified format.  If no files are specified on the command
  3273. line (or in a configuration file), then GDS assumes that all files in the
  3274. current directory are to be converted, so be careful about specifying which
  3275. files to convert.
  3276.  
  3277. The /@C command line parameter takes two additional values specified directly
  3278. after one another.  The first parameter is a letter signifying the destination
  3279. format.  The second parameter is the number of bits per pixel.  Note that some
  3280. formats do not support certain bit depths, so be sure to specify only those
  3281. combinations which are supported.
  3282. 
  3283.  /@C<t><c> - Convert files from command line
  3284. 
  3285.     <t> Destination File Type
  3286.         A = ANSI    P = PCX
  3287.         B = BMP        R = ColorRIX
  3288.         D = CUT/PAL    T = TGA
  3289.         I = TIFF    W = GIF
  3290.         L = IFF/LBM    Y = WPG
  3291.         J = JPEG
  3292. 
  3293.     <c> Destination File Bit Depth (determines number of colors)
  3294.         1 = monochrome        15 = 32,768 colors
  3295.         2 = 4 colors        16 = 65,536 colors
  3296.         4 = 16 colors        24 = 16.7 million colors
  3297.         8 = 256 colors
  3298.  
  3299. For example, /@CW8 converts all specified files to 256 color GIF files, while
  3300. /@CJ24 converts them to 24 bit JPEG files.  Note that /@CJ8 is not legal,
  3301. because color JPEG files are always considered to be 24 bits.  The following
  3302. combinations are valid:
  3303. 
  3304.     hlConvANSI/@CA    (ANSI, 16 color text)
  3305.     hlConvBMP1/@CB1    (BMP monochrome)
  3306.     hlConvBMP4/@CB4    (BMP 16 colors)
  3307.     hlConvBMP8/@CB8    (BMP 256 colors)
  3308.     hlConvBMP24/@CB24    (BMP 16.7 million colors)
  3309.     hlConvCUT1/@CD1    (Halo CUT/PAL monochrome)
  3310.     hlConvCUT4/@CD4    (Halo CUT/PAL 16 colors)
  3311.     hlConvCUT8/@CD8    (Halo CUT/PAL 256 colors)
  3312.     hlConvJPG24/@CJ24    (JPEG 16.7 million colors)
  3313.     hlConvGIF1/@CW1    (GIF monochrome)
  3314.     hlConvGIF4/@CW4    (GIF 16 colors)
  3315.     hlConvGIF8/@CW8    (GIF 256 colors)
  3316.     hlConvLBM1/@CL1    (LBM/IFF monochrome)
  3317.     hlConvLBM4/@CL4    (LBM/IFF 16 colors)
  3318.     hlConvLBM8/@CL8    (LBM/IFF 256 colors)
  3319.     hlConvPCX1/@CP1    (PCX monochrome)
  3320.     hlConvPCX4/@CP4    (PCX 16 colors)
  3321.     hlConvPCX8/@CP8    (PCX 256 colors)
  3322.     hlConvRIX4/@CR4    (ColorRIX 16 colors)
  3323.     hlConvRIX8/@CR8    (ColorRIX 256 colors)
  3324.     hlConvTIF1/@CI1    (TIFF monochrome)
  3325.     hlConvTIF4/@CI4    (TIFF 16 colors)
  3326.     hlConvTIF8/@CI8    (TIFF 256 colors)
  3327.     hlConvTIF24/@CI24    (TIFF 16.7 million colors)
  3328.     hlConvTGA15/@CT15    (TGA 32K colors)
  3329.     hlConvTGA24/@CT24    (TGA 16.7 million colors)
  3330.     hlConvWPG1/@CY1    (WPG monochrome)
  3331.     hlConvWPG4/@CY4    (WPG 16 colors)
  3332.     hlConvWPG8/@CY8    (WPG 256 colors)
  3333.  
  3334. If GDS can write the output files without overwriting a file with the same
  3335. name, then the default file name will be preserved.  If files with the same
  3336. name are found, then GDS will write out those files with a filename like
  3337. GDS000, GDS001, GDS002, etc.
  3338. 
  3339. See also: hlConvMenuUsing the Convert Menu, hlHowToConvertConverting Files,
  3340.     hlViewWriteConverting via View Menus, hlViewModeMenuView Mode File Menu
  3341.     hlViewWriteConverting via View Menus, hlViewModeMenuView Mode File Menu
  3342.  
  3343.  
  3344. :::hlFormats
  3345. SUPPORTED FILE FORMATS
  3346.  
  3347. Photodex is constantly making adjustments and upgrades to the file format
  3348. support in GDS.  If you encounter any incompatibilities with files, please
  3349. hlPhotodexcontact us.
  3350.  
  3351. GDS supports the following file formats:
  3352.  
  3353.             Bit Depth (* = R&W)
  3354. Ext.    Read    Write    1 2 4 8 15 16 24 32    Description
  3355. ────    ────    ─────    ───────────────────    ───────────
  3356. .ANS    Yes    Yes    - - (text mode) - -    Color ANSI text (BBS)
  3357. .TXT    Yes    Yes    - - (text mode) - -    Generic text (ANSI opt.)
  3358. .BBM    Yes    Yes    *   * *    Rd Rd ** Rd    Deluxe Paint (IFF 'Brush')
  3359. .BMP    Yes    Yes    *   * *       **    Microsoft Windows Bitmap
  3360. .CUT    Yes    Yes    *   * *            Media Cybernetics (HALO)
  3361. .FLI     <externl>    <N/A>            AutoDesk (QUICKFLI.EXE)
  3362. .GDS    Yes    Yes    * R R *    Rd Rd ** Rd    Raxsoft/Photodex Scanning
  3363. .GIF    Yes    Yes    * * * *            CompuServe GIF87/GIF89a
  3364. .GL     <externl>    <N/A>            Grasp (GRASPRT.EXE)
  3365. .HAM    Yes    Yes    *   * * Rd Rd ** Rd    Electronic Arts (IFF/HAM)
  3366. .IFF    Yes    Yes    *   * * Rd Rd ** Rd    Electronic Arts (IFF/HAM)
  3367. .JPG    Yes    Yes          R          ** Rd    JPEG (standard JFIF)
  3368. .LBM    Yes    Yes    *   * *    Rd Rd ** Rd    Deluxe Paint (IFF/HAM)
  3369. .MAC    Yes     -    R            Macintosh MacPaint Mono
  3370. .PCC    Yes    Yes    * R * *          Rd    ZSoft PC Paintbrush 'Brush'
  3371. .PCX    Yes    Yes    * R * *          **    ZSoft PC Paintbrush
  3372. .RAX    Yes    Yes    * R * *    **    ** Rd    Raxsoft/Photodex VideoGames
  3373. .RFX    Yes    Yes    * R * *    **    ** Rd    Raxsoft/Photodex Fonts
  3374. .RLE    Yes     -    R   R R       Rd    Windows RLE Bitmap
  3375. .SC*    Yes    Yes        * *            ColorRIX
  3376. .TGA    Yes    Yes          R    **    ** Rd    Truevision Targa
  3377. .TIF    Yes    Yes    * R * *    Rd Rd ** Rd    Tagged Image File Format
  3378. .WPG    Yes    Yes    * R * *            WordPerfect Graphics (Bitmap)
  3379.  
  3380. Note that many bit depths are meaningless in most formats, so blanks above
  3381. do not necessarily indicate a deficiency in the support for the format.
  3382.  
  3383. JPEG and TIFF files can be stored in CMYK format, which GDS automatically
  3384. converts to 24 bit RGB for processing.
  3385.  
  3386. NOTE: GDS's IFF code is correct.  There are many programs which write bad
  3387. IFF files, and there are even books available incorrectly describing how IFF
  3388. works.  Adobe Photoshop and Graphics Workshop (and perhaps other programs)
  3389. appear to read IFF/LBM/HAM files incorrectly, and may write incorrectly
  3390. compressed IFF files also.  Please be careful to follow Electronic Arts' IFF
  3391. specifications precisely.
  3392.  
  3393.  
  3394. :::hlViewModeMenu
  3395. View Mode Menus
  3396.  
  3397. When viewing an image the following View Mode Menus can be accessed by
  3398. clicking the mouse button while the cursor is near the top edge of the
  3399. screen.  If you do not select an option when releasing the mouse button,
  3400. the view mode menus disappear and you are returned harmlessly to viewing
  3401. the current image file.
  3402.  
  3403. Note:  There is no way to access View Mode Menus without a mouse.  Most
  3404. options in the View Mode Menus have keyboard equivalents which are listed
  3405. in each menu.
  3406.  
  3407. hlViewModeMenuFile File  hlViewModeMenuEdit Edit  hlViewModeMenuColor Color  hlViewModeMenuSize Size  hlViewModeMenuPrint Print  hlViewModeMenuRes (Resolution) 
  3408.  
  3409.  
  3410. :::hlViewModeMenuFile
  3411. View Mode File Menu
  3412.  
  3413. The View Mode File Menu is used to write the displayed image (or a cropped
  3414. portion of the image) to an image file, and to set the cropping rectangle,
  3415. as well as obtaining file information and exiting View Mode.  (Note that it
  3416. is usually much easier to exit View Mode by pressing the [Esc] key.)
  3417. 
  3418.     hlVMMFSaveANSSave ANS      Alt-A
  3419.     hlVMMFSaveGIFSave CUT/PAL      Alt-D
  3420.     hlVMMFSaveGIFSave GIF      Alt-W
  3421.     hlVMMFSaveLBMSave LBM      Alt-L
  3422.     hlVMMFSavePCXSave PCX      Alt-P
  3423.     hlVMMFSaveBMPSave BMP      Alt-B
  3424.     hlVMMFSaveRIXSave RIX      Alt-R
  3425.     hlVMMFSaveTGASave TGA      Alt-T
  3426.     hlVMMFSaveTIFSave TIF      Alt-I
  3427.     hlVMMFSaveJPGSave JPG      Alt-J
  3428.     hlVMMFSaveWPGSave WPG      Alt-Y
  3429.     -----------------------
  3430.     hlVMMFSetCropSet Cropping      Alt-C
  3431.     hlVMMFResetCropReset Cropping
  3432.     -----------------------
  3433.     hlVMMFFileInfoFile Info (?)
  3434.     -----------------------
  3435.     hlVMMFQuitQuit            Esc
  3436.  
  3437.  
  3438. :::hlVMMFSaveANS
  3439. Save ANSI 16 Color Text File
  3440.  
  3441. Selecting this option from the View Mode File Menu (or hitting [Alt-A]) will
  3442. create a file using the entire screen image or a portion of the screen image
  3443. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
  3444. be dithered down to the standard 16 color ANSI palette and size (79
  3445. characters wide. 
  3446.  
  3447. This function is supported in GDS Professional
  3448.  
  3449. :::hlVMMFSaveGIF
  3450. Save GIF (CompuServe GIF89a) File
  3451.  
  3452. Selecting this option from the View Mode File Menu (or hitting [Alt-W]) will
  3453. create a file using the entire screen image or a portion of the screen image
  3454. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
  3455. be dithered down to 256 colors.
  3456.  
  3457.  
  3458. :::hlVMMFSaveLBM
  3459. Save LBM (Deluxe Paint) File
  3460.  
  3461. Selecting this option from the View Mode File Menu (or hitting [Alt-L]) will
  3462. create a file using the entire screen image or a portion of the screen image
  3463. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
  3464. be dithered down to 256 colors.
  3465.  
  3466.  
  3467. :::hlVMMFSavePCX
  3468. Save PCX (Paint) File
  3469.  
  3470. Selecting this option from the View Mode File Menu (or hitting [Alt-P]) will
  3471. create a file using the entire screen image or a portion of the screen image
  3472. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
  3473. be dithered down to 256 colors.
  3474.  
  3475.  
  3476. :::hlVMMFSaveBMP
  3477. Save BMP (Windows Bitmap) File
  3478.  
  3479. Selecting this option from the View Mode File Menu (or hitting [Alt-B]) will
  3480. create a file using the entire screen image or a portion of the screen image
  3481. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3482.  
  3483.  
  3484. :::hlVMMFSaveRIX
  3485. Save RIX (ColorRix) File
  3486.  
  3487. Selecting this option from the View Mode File Menu (or hitting [Alt-R]) will
  3488. create a file using the entire screen image or a portion of the screen image
  3489. selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes
  3490. will be dithered down to 256 colors.
  3491.  
  3492.  
  3493. :::hlVMMFSaveTIF
  3494. Save TIF (Tagged Image File Format) File
  3495.  
  3496. Selecting this option from the View Mode File Menu (or hitting [Alt-I]) will
  3497. create a file using the entire screen image or a portion of the screen image
  3498. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3499.  
  3500.  
  3501. :::hlVMMFSaveTGA
  3502. Save TGA (Targa) File
  3503.  
  3504. Selecting this option from the View Mode File Menu (or hitting [Alt-T]) will
  3505. create a file using the entire screen image or a portion of the screen image
  3506. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3507.  
  3508.  
  3509. :::hlVMMFSaveJPG
  3510. Save JPG (JPEG) File
  3511.  
  3512. Selecting this option from the View Mode File Menu (or hitting [Alt-J]) will
  3513. create a file using the entire screen image or a portion of the screen image
  3514. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3515.  
  3516.  
  3517. :::hlVMMFSaveWPG
  3518. Save WPG (Word Perfect Graphics) File
  3519.  
  3520. Selecting this option from the View Mode File Menu (or hitting [Alt-Y])
  3521. creates a file using the entire screen image or a portion of the screen image
  3522. selected with the hlVMFMSetCropSet Crop Rectangle command.
  3523.  
  3524.  
  3525. :::hlVMMFSetCrop
  3526. Set Crop Rectangle
  3527.  
  3528. Selecting Set Crop Rect. from the View Mode File Menu (or hitting [Alt-C)
  3529. will begin the crop function.  Place the mouse cursor one corner of the area
  3530. to be cropped.  Hold down the mouse button and drag the Crop Rectangle that
  3531. appears so it contains the desired area. Only the area inside the Crop
  3532. Rectangle will be saved by using one of the Save commands from the View Mode
  3533. File Menu.
  3534.  
  3535.  
  3536. :::hlVMMFResetCrop
  3537. Reset Crop Rectangle
  3538.  
  3539. Selecting this option from the View Mode File Menu will reset the hlVMMFSetCropCrop
  3540. hlVMMFSetCropRectangle to contain the entire screen area.
  3541.  
  3542.  
  3543. :::hlVMMFFileInfo
  3544. File Information
  3545.  
  3546. Selecting File Info From the View Mode File Menu (or hitting [?]) will
  3547. display helpful information about the file being viewed including the
  3548. filename, extension (file type), resolution, number of colors, and even the
  3549. total number of dots (very important!)
  3550.  
  3551.  
  3552. :::hlVMMFQuit
  3553. Quit View Mode
  3554.  
  3555. Selecting Quit form the View Mode File Menu (or hitting [Esc]) will exit View
  3556. Mode to the File List.  Also, clicking the mouse button exits except on
  3557. Catalog screens.
  3558.  
  3559.  
  3560. :::hlViewModeMenuEdit
  3561. View Mode Edit Menu
  3562. The View Mode Edit Menu provides several image functions, including rotation,
  3563. axis flipping, mouse panning and the ability to reset the orientation of the
  3564. displayed image file.
  3565. 
  3566.     hlVMMERotateRotate 90 Deg.        /
  3567.     ---------------------
  3568.     hlVMMEFlipHorzFlip Horizontal        H
  3569.     hlVMMEFlipVertFlip Vertical        V
  3570.     ---------------------
  3571.     hlVMMEPanPan Image w/Mouse   P
  3572.     ---------------------
  3573.     hlVMMEResetReset Orientation
  3574.  
  3575.  
  3576. :::hlVMMERotate
  3577. Rotate 90 Degrees
  3578.  
  3579. Selecting Rotate 90 Deg. (or hitting /) rotates the image on the screen
  3580. 90 degrees clockwise.
  3581.  
  3582.  
  3583. :::hlVMMEFlipHorz
  3584. Flip Horizontal
  3585.  
  3586. Selecting Flip Horizontal (or hitting H) creates a mirror image of the
  3587. file displayed on the screen.
  3588.  
  3589.  
  3590. :::hlVMMEFlipVert
  3591. Flip Horizontal
  3592.  
  3593. Selecting Flip Horizontal (or hitting H) creates a vertical mirror image
  3594. of the file displayed on the screen.
  3595.  
  3596.  
  3597. :::hlVMMEPan
  3598. Pan Image with Mouse
  3599.  
  3600. Selecting Pan Image w/Mouse (or hitting P) puts GDS in panning mode. Hold
  3601. down the mouse button and move the mouse to pan the image on the screen. When
  3602. the mouse button is released GDS will exit panning mode.
  3603.  
  3604.  
  3605. :::hlVMMEReset
  3606. Reset Orientation
  3607.  
  3608. Selecting Reset Orientation undoes all other View Mode Edit Menu commands
  3609. restoring an image to its original orientation.
  3610.  
  3611.  
  3612. :::hlViewModeMenuColor
  3613. View Mode Color Menu
  3614.  
  3615. The View Mode Color Menu is used to manipulate the color content of the
  3616. current image file.  Note that this menu has no effect in video modes with
  3617. 15, 16 or 24 bits per pixel (32k, 64k and 16.7 million colors), although
  3618. it will still allow the user to select from it.
  3619.  
  3620.     hlVMMCGrayGrayscale
  3621.     hlVMMCmaxMaximum Color
  3622.     -----------------------
  3623.     hlVMMCInvertInvert Palette          '
  3624.     -----------------------
  3625.     hlVMMCResetColorReset Color Intensity <
  3626.     hlVMMCResetAllReset All Settings
  3627.  
  3628.  
  3629. :::hlVMMCGray
  3630. Grayscale
  3631.  
  3632. Selecting Grayscale converts a color image into shades of gray. This
  3633. command has no effect if using a screen mode supporting more than 256 colors.
  3634.  
  3635.  
  3636. :::hlVMMCMax
  3637. Maximum Color
  3638.  
  3639. Selecting Maximum Color saturates the colors in an image. This command
  3640. has no effect if using a screen mode supporting more than 256 colors.
  3641.  
  3642.  
  3643. :::hlVMMCInvert
  3644. Invert Palette
  3645.  
  3646. Selecting Invert Palette (or hitting ~) creates a "negative" version of an
  3647. image. This command has no effect if using a screen mode supporting more than
  3648. 256 colors.
  3649.  
  3650.  
  3651. :::hlVMMCResetColor
  3652. Reset Color Intensity
  3653.  
  3654. Selecting Reset Color Intensity (or hitting <) reverts all View Mode Color
  3655. Menu options to their original state.
  3656.  
  3657.  
  3658. :::hlVMMCResetAll
  3659. Reset All Setting
  3660.  
  3661. Selecting Reset All Settings reverts all View Mode options to their original
  3662. state. The spacebar also restores an image to its original state.
  3663.  
  3664.  
  3665. :::hlViewModeMenuSize
  3666. View Mode Size Menu
  3667.  
  3668. The View Mode Size Menu provides size alteration and positioning of the
  3669. current image file.
  3670.  
  3671.     hlVMMSFitFit To Screen     Alt-F
  3672.     hlVMMSSetZoomSet Zoom Rect.     Alt-Z
  3673.     ----------------------
  3674.     hlVMMSDoubleXDouble X
  3675.     hlVMMSDoubleYDouble Y
  3676.     hlVMMSDoubleXYDouble Both X/Y
  3677.     ----------------------
  3678.     hlVMMSHalfXHalf X
  3679.     hlVMMSHalfYHalf Y
  3680.     hlVMMSHalfXYHalf Both X/Y
  3681.     ----------------------
  3682.     hlVMMSCenterCenter Image     Alt-S
  3683.     ----------------------
  3684.     hlVMMSResetReset Scale Parameters
  3685.  
  3686.  
  3687. :::hlVMMSFit
  3688. Fit Image to Screen
  3689.  
  3690. Selecting Fit To Screen (or hitting [Ctrl-F]) changes an image smaller or
  3691. larger than the current screen mode to match the dimensions of the screen.
  3692.  
  3693.  
  3694. :::hlVMMSSetZoom
  3695. Set Zoom Rectangle
  3696.  
  3697. Selecting Set Zoom Rectangle (or hitting [Alt-Z]) places GDS in zoom mode.
  3698. Move the mouse cursor to one corner of the area to be zoomed. Hold down the
  3699. mouse button and drag the mouse until the desired area is within the Zoom
  3700. Rectangle. Release the mouse button and GDS zoom the selected area to fill
  3701. the screen.
  3702.  
  3703. Related Topics
  3704.     hlVMCZoomOMaticInstant Zoom (Zoom'O'Matic)
  3705.  
  3706.  
  3707. :::hlVMMSDoubleX
  3708. Double X
  3709.  
  3710. Selecting this option will double the width of an image.
  3711.  
  3712.  
  3713. :::hlVMMSDoubleY
  3714. Double Y
  3715.  
  3716. Selecting this option will double the height of an image.
  3717.  
  3718.  
  3719. :::hlVMMSDoubleXY
  3720. Double X and Y
  3721.  
  3722. Selecting this option will double the height and width of an image.
  3723.  
  3724.  
  3725. :::hlVMMSHalfX
  3726. Half X
  3727.  
  3728. Selecting this option will halve the width of an image.
  3729.  
  3730.  
  3731. :::hlVMMSHalfY
  3732. Half Y
  3733.  
  3734. Selecting this option will halve the height of an image.
  3735.  
  3736.  
  3737. :::hlVMMSHalfXY
  3738. Half X and Y
  3739.  
  3740. Selecting this option will halve the height and width of an image.
  3741.  
  3742.  
  3743. :::hlVMMSCenter
  3744. Center Image
  3745.  
  3746. Selecting Center Image (or hitting [Ctrl-S]) places the displayed image in
  3747. the center of the screen.
  3748.  
  3749.  
  3750. :::hlVMMSReset
  3751. Reset Scale Parameters
  3752.  
  3753. Selecting Reset Scale Parameters reverts all View Mode Size
  3754. Menu options to their original state.
  3755.  
  3756.  
  3757. :::hlViewModeMenuPrint
  3758. View Mode Print Menu
  3759.  
  3760. The print menu allows you to print the currently displayed image file (or a
  3761. portion selected with the Alt-C function) directly from the screen.  Note
  3762. that graphics printing is supported only by registered versions of GDS.
  3763.  
  3764.            hlVMMPPrintPrint Portrait
  3765.     hlVMMPPrintPrint Landscape
  3766.  
  3767. Note:  Printing graphics is supported in enhanced versions of GDS only.
  3768.  
  3769. :::hlVMMPPrint
  3770. Print Portrait or Landscape
  3771.  
  3772. These menu options will print the currently hlHowToSelectselected file in either portrait
  3773. (10" tall) or landscape (10" wide) mode on HP LaserJets, DeskJets and 100%
  3774. compatible PCL printer language printers.  Additionally, GDS will print in
  3775. color on the DeskJet 500C, 550C, 560C, and 1200C.  The correct port must be
  3776. selected in the Setup Menu: Printer On... section.
  3777.  
  3778. Note:  Printing graphics is supported in enhanced versions of GDS only.
  3779.  
  3780. :::hlViewModeMenuRes
  3781. View Mode Resolution Menu
  3782.  
  3783. The Viewmode Resolution Menu lists the current video resolution on the menu
  3784. bar.  The video mode may be changed by selecting a different video resolution
  3785. from this menu.  From top to bottom, the menu is organized into sections of
  3786. similar numbers of colors (bit depths), and then by resolution within each
  3787. section.
  3788.  
  3789. *Note:  GDS does NOT display the current video mode in the resolution menu,
  3790.     because doing so would be pointless, and would waste space which
  3791.     can be better used for a different possible resolution.
  3792.  
  3793. GDS can display up to 25 modes in the resolution menu.  Because they are
  3794. sorted by bit depth, the highest (coolest) video modes are nearest to the
  3795. top of the menu, making them more convenient to select.
  3796.  
  3797.  
  3798. :::hlHowToSelect
  3799. How To Select Files
  3800.  
  3801. Selecting files is very important because it determines files to be included
  3802. in catalogs, slideshows as well as batch conversions and printouts.
  3803.  
  3804. File selection is simple; just click with the mouse and a file is selected.
  3805. Double clicking on a file initiates viewing the file, which can also be done
  3806. with the keyboard by pressing the [Enter] key.
  3807.  
  3808. There are several variations of selecting files which make things like
  3809. selecting ranges and selecting arbitrary sets of files.  The two major ways
  3810. to select files are with a mouse, and with the keyboard.  Mouse selection is
  3811. described separately from keyboard selection.
  3812.  
  3813. Mouse Selection
  3814. ───────────────
  3815.   To select a single file, move the mouse cursor over the file and click the
  3816.   mouse button.  To deselect it, click the button again.  Note that if you
  3817.   click twice, you will actually initiate viewing the image, so to deselect,
  3818.   make sure there has been about a half-second delay.
  3819.  
  3820.   To select a range of files, move the mouse over the first file, click AND
  3821.   HOLD the mouse button, and then drag the mouse to the last file and release
  3822.   the mouse button.
  3823.  
  3824.   Normally, when you click a mouse button on the file list, all currently
  3825.   selected files are deselected.  To prevent this, hold down the [Shift] key
  3826.   while performing your selections.  The [Shift] key allows you to toggle
  3827.   both single and range selections.
  3828.  
  3829. Keyboard Selection
  3830. ──────────────────
  3831.   Keyboard selection is simpler but less flexible.  Simply user the arrow
  3832.   keys to move the file cursor to the file to select and press the [Space Bar]
  3833.   key.  Each time you press the [Space Bar] key, GDS toggles the selection
  3834.   state of the highlighted file and then moves the file cursor to the next
  3835.   entry.
  3836.  
  3837.   To select a range of files, just use the arrow keys to the first file and
  3838.   then hold down the [Space Bar] until all of the files are selected.
  3839.  
  3840. Quick Letter 'Go To' Function
  3841. ─────────────────────────────
  3842.   This is an obscure function which can be very handy.  Just type a letter or
  3843.   number on the keyboard, and GDS will move to the first file in the file
  3844.   list which has a filename which begins with the same letter or a letter
  3845.   following the typed letter in the alphabet.  This function is somewhat
  3846.   defeated when the sort order is not set to hlDisplayMenuSortSort: Name Extn, but is
  3847.   useful to be aware of.
  3848.  
  3849.  
  3850. :::hlViewModeCommands
  3851. View Mode Command Reference
  3852.  
  3853. The following keyboard commands are available when viewing images.
  3854.  
  3855.     hlVMMFQuit<Esc>- Exit
  3856.   hlVMMCResetAll<Space>- Restore Original Image 
  3857.       hlVMCZoomOMatic<Z>- Zoom'O'Matic
  3858.       hlVMMFFileInfo<?>- File information
  3859.   hlVMMFSaveBMP<Alt-B>- Write .BMP (Windows Bitmap)
  3860.   hlVMMFSaveTIF<Alt-I>- Write .TIF (Tagged Image File Format)
  3861.   hlVMMFSaveLBM<Alt-L>- Write .LBM (Deluxe Paint)
  3862.   hlVMMFSavePCX<Alt-P>- Write .PCX (ZSoft PC Paintbrush)
  3863.   hlVMMFSaveSCx<Alt-R>- Write .SCx (ColorRIX)
  3864.   hlVMMFSaveTGA<Alt-T>- Write .TGA (Targa)
  3865.   hlVMMFSaveGIF<Alt-W>- Write .GIF (CompuServe GIF89a)
  3866.   hlVMMFSaveJPG<Alt-J>- Write .JPG (JPEG/JFIF format)
  3867.   hlVMMFSaveANS<Alt-A>- Write .ANS (ANSI text)
  3868.   hlVMMFSaveANS<Alt-Y>- Write .WPG (WordPerfect)
  3869.     hlVMCColorLevelF1/F2- Red level 
  3870.     hlVMCColorLevelF3/F4- Green level
  3871.     hlVMCColorLevelF5/F6- Blue level
  3872.     hlVMCContrastF7/F8- Contrast
  3873.    hlVMCBrightnessF9/F10- Brightness
  3874.   hlVMCHueF11/F12- Hue
  3875.   hlVMCColorLevel','/'.'- Color level
  3876. hlVMMERotateslash '/'- Rotate 90 degrees
  3877. hlVMMCInverttilde '~'- Invert palette
  3878.       hlVMMEFlipHorz'H'- Flip Horizontal
  3879.       hlVMMEFlipVert'V'- Flip Vertical
  3880.       hlVMMEPan'P'- Pan image with mouse.
  3881.  hlVMCScaleplus '+'- Scale image up 5% larger
  3882. hlVMCScaleminus '-'- Scale image down 5% smaller
  3883.   hlVMMSFit<Alt-F>- Fit image to screen
  3884.   hlVMMSCenter<Alt-S>- Center image
  3885.   hlVMMFSetCrop<Alt-C>- Set "crop" rectangle
  3886.   hlVMMSSetZoom<Alt-Z>- Set "zoom" rectangle
  3887.    hlVMCArrowArrows- Resize Image
  3888. hlVMCKeyboardPan   <E>     
  3889. hlVMCKeyboardPan         
  3890. hlVMCKeyboardPan<S>-■-<D>- Keyboard panning 
  3891. hlVMCKeyboardPan          
  3892. hlVMCKeyboardPan   <X>     
  3893.   hlVMCSharp<PgUp> - Increase sharpening
  3894.   hlVMCSharp<PgDn> - Decrease sharpening
  3895.      hlVMCQuote<'> - Undocumented quote function
  3896.  
  3897.  
  3898. :::hlVMCZoomOMatic
  3899. Zoom'O'Matic
  3900.  
  3901.       [Z]- Zoom'O'Matic for 2-256 color displays.  (Requires XMS)
  3902. 
  3903.              While zooming:  * Mouse pans the image in real-time
  3904.                              * Up and down arrows increase and decrease zoom
  3905.                              * Number keys (1-9) set zoom magnification level
  3906.                              * Any other key or mouse button exit zoom mode
  3907. :::hlVMCColorLevel
  3908. View Mode Color Adjustments
  3909.  
  3910. These keys adjust the appearance of an image while viewing.
  3911.  
  3912.     F1/F2- Red level    Use <Shift> to reset
  3913.     F3/F4- Green level   "
  3914.     F5/F6- Blue level    "
  3915.     , / .- Color level   "
  3916.  
  3917.     *Note:    These keys may not work if the video mode supports more
  3918.         than 256 colors.
  3919.  
  3920. :::hlVMCContrast
  3921. View Mode Contrast Adjustment
  3922.  
  3923. These keys adjust the variation between light and dark areas of an image.
  3924.  
  3925.     F7/F8- Contrast      Use <Shift> to reset
  3926.  
  3927.     *Note:    These keys may not work if the video mode supports more
  3928.         than 256 colors.
  3929.  
  3930. :::hlVMCBrightness
  3931. View Mode Brightness Adjustment
  3932.  
  3933. These keys brighten or darken an image.
  3934.  
  3935.     F9/F10- Brightness   Use <Shift> to reset
  3936.  
  3937.     *Note:    These keys may not work if the video mode supports more
  3938.         than 256 colors.
  3939.  
  3940. :::hlVMCHue
  3941. View Mode Hue Adjustment
  3942.  
  3943. These keys alter the hue of an image.
  3944.  
  3945.   F11/F12- Hue        Use <Shift> to reset           
  3946.  
  3947.     *Note:    These keys may not work if the video mode supports more
  3948.         than 256 colors.
  3949.  
  3950. :::hlVMCScale
  3951. View Mode Image Scaling
  3952.  
  3953. These keys alter the size of an image either larger or smaller and maintains
  3954. the aspect ratio.
  3955.  
  3956.  plus '+'- Scale image up 5% larger
  3957. minus '-'- Scale image down 5% smaller
  3958.  
  3959. Related Topics
  3960.     hlVMCArrowArrow Keys (in View Mode)
  3961.     hlVMMSDoubleXYDouble X/Y (from hlViewModeMenuSizeView Mode Size Menu) 
  3962.     hlVMMSHalfXYHalf X/Y (from hlViewModeMenuSizeView Mode Size Menu)
  3963.  
  3964.  
  3965. :::hlVMCArrow
  3966. View Mode Arrow Keys
  3967.  
  3968. Use the arrows to move the lower right corner of the image around.  Hold down
  3969. the <Shift> key to move 20 pixels rather than one each. Using these keys will
  3970. not maintain the aspect ratio of an image. To maintain the aspect ratio use
  3971. the hlVMCScale+ and - keys instead.
  3972.  
  3973. Related Topics
  3974.     hlVMCScale+ (Plus) and - (Minus) keys (in View Mode)
  3975.     hlVMMSDoubleXYDouble X/Y (from hlViewModeMenuSizeView Mode Size Menu) 
  3976.     hlVMMSHalfXYHalf X/Y (from hlViewModeMenuSizeView Mode Size Menu)
  3977.  
  3978.  
  3979. :::hlVMCKeyboardPan
  3980. Panning an Image from the Keyboard
  3981.  
  3982. These keys pan the image up, down, left, and right.  If the <Shift>
  3983. key is held, then they pan the image 20 pixels rather than one.
  3984. 
  3985.               Pan Up
  3986. 
  3987.                <E>
  3988.                 
  3989.            Pan Left    <S>-■-<D> Pan Right
  3990.                       
  3991.                <X>
  3992. 
  3993.              Pan Down
  3994. 
  3995. Related Topics
  3996.     hlVMMEPanPan Image with Mouse (from hlViewModeMenuEditView Mode Edit Menu)
  3997.  
  3998.  
  3999. :::hlVMCSharp
  4000. View Mode Sharpening
  4001.  
  4002. These keys increase or decrease the level of sharpening on images with more
  4003. than 256 colors (15, 16, or 24 bit color)
  4004.  
  4005.   <PgUp> - Increase sharpening
  4006.  
  4007.   <PgDn> - Decrease sharpening
  4008.  
  4009.  
  4010. :::hlVMCQuote
  4011. Undocumented Quote Feature
  4012.  
  4013.      <'> - Undocumented quote function.  Use with free spirit.
  4014.  
  4015. :::hlBBS
  4016. Cataloging a BBS with GDS
  4017.  
  4018. GDS is used by hundreds of BBS system operators around the world to manage,
  4019. verify, review, categorize and catalog thousands of graphics files.  GDS has
  4020. many functions specifically designed for BBS system operators (sysops), which
  4021. not only make these tasks easier, but can add features to an existing BBS.
  4022.  
  4023. GDS's Special BBS Features
  4024.    ■ Instantly view new graphics files, delete junk and move good files.
  4025.  
  4026.    ■ Catalog CD's to quickly see if content is worth anything.
  4027.  
  4028.    ■ Catalog downloadable graphics files and provide catalogs to callers.
  4029.      Note:  BBS users love this offering, see the section below about BBS
  4030.      file catalogs for details about how to determine what's right for
  4031.      your system.
  4032.  
  4033.    ■ Insert your system logo graphic into GDS catalogs automatically.  There
  4034.      are even systems which have random batch files which vary the logo and
  4035.      placement in order to provide variety.
  4036.  
  4037.    ■ Provide on-line tagged file cataloging.  GDS has a special standardized
  4038.      user interface designed to insert into an existing BBS.  Several BBS
  4039.      developers are putting specific hooks as well.
  4040.  
  4041.    ■ Customize system to use GDS as a tool, both for user and system
  4042.      functions.  GDS provides hundreds of command line and batch functions
  4043.      which can be easily incorporated into an existing BBS.
  4044.  
  4045.    ■ GDS Professional instantly converts graphics files to ANSI via command
  4046.      line parameters, so users can get an ANSI preview of a graphic file
  4047.      within 10 seconds to help them decide to download it.
  4048.  
  4049. There are many reasons to provide catalogs of your system.  First, users love
  4050. it because they can avoid online time and get to just the graphics files which
  4051. look interesting.  This clears your phone lines and allows you to get more
  4052. users on the system.
  4053.  
  4054. Catalogs give you a competitive edge against text-only systems.  Many users of
  4055. BBS systems are frustrated that they do not have a way to preview a large file
  4056. before they commit to a download.  With GDS catalogs, they can commit to the
  4057. catalog download, and then know roughly what to expect when they commit to a
  4058. file download.
  4059.  
  4060. There are many ways to provide catalogs, because there are many preferences
  4061. and organization structures that BBS systems use to categorize files.  The
  4062. methods which work best are as follows:
  4063.  
  4064.    ■ Decide on a standard look for your catalogs.  Consistency and uniqueness
  4065.      will eventually become a successful BBS's calling card.
  4066.  
  4067.    ■ Provide a section which catalogs all areas of the BBS.  Even if you have
  4068.      thousands of graphics files in hundreds of areas, users still one to have
  4069.      a "one stop shop" type of area on a BBS.  Don't try to make lots of areas
  4070.      with lots of catalog runs.
  4071.  
  4072.    ■ Use 25 or more pictures per catalog screen, and try to provide both GIF
  4073.      and JPEG format.  Users with 15, 16 or 24 bit displays really appreciate
  4074.      JPEG catalogs, and JPEG catalogs are much smaller than their GIF cousins.
  4075.  
  4076.    ■ Consider providing very dense catalogs for people who want a quick
  4077.      overview of a huge amount of files.  For example, you may want to have a
  4078.      run of catalogs which has 100 thumbnails per screen at 1024x768 or
  4079.      1280x1024.  This gives power users the ability to use the "brute force"
  4080.      that makes them feel more powerful.  They appreciate this "high end"
  4081.      attention and will rave about your efforts.  Once again, use JPEG to get
  4082.      the file size down!
  4083.  
  4084.    ■ Provide ANSI conversion of graphics files.  ANSI files are small and can
  4085.      be displayed by nearly all text terminal programs with no changes.
  4086.  
  4087.    ■ Consider adding options to provide single thumbnail download.  GDS can
  4088.      generate a 160x120 JPEG thumbnail of a GIF file in about 4 seconds,
  4089.      which can be downloaded to the user in about 7 seconds.  A user could
  4090.      select a file and have a thumbnail to review within 15-20 seconds.
  4091.  
  4092.  
  4093. :::hlOFrm
  4094. GDS PURCHASE ORDER AND REGISTRATION FORM
  4095. I would like a copy of GDS!  I understand that I will receive a
  4096. personalized copy, registered in my name, that I may freely use for any
  4097. personal purpose that I wish.  I also understand that GDS is protected
  4098. by Federal Copyright Laws and International Treaty Provisions and will
  4099. not copy or distribute GDS or any part of GDS.  I understand that my
  4100. correct phone number is required for registration and will be kept
  4101. strictly confidential.  Items marked with an asterisk (*) are optional.
  4102.  
  4103. Name of user:_________________________________________________________
  4104. (PLEASE PRINT CLEARLY)    First Name,  Initial,  Last name
  4105.  
  4106. *Company:_____________________________ *Work: (______) ______-________
  4107.  
  4108. Addr:_________________________________  Home: (______) ______-________
  4109.  
  4110.      _________________________________
  4111.                                             *Favorite Pop Star:_______
  4112.      _________________________________
  4113.  
  4114. City:_____________________________ State/Prov:_________ Zip:__________
  4115.  
  4116. READ THE FOLLOWING AND TRUTHFULLY MARK ONE OF THE TWO BOXES BELOW:
  4117. [_] I DO control a bulletin board system (BBS).  I understand that any
  4118. purchased copy of GDS is not in the public domain, and is not to be
  4119. made available for download by users of my or any other BBS.  I
  4120. understand that making such files available for download could result
  4121. in legal action of up to $100,000 per infraction.  To certify that I
  4122. understand this clause, I hereby write my initials:___________________
  4123. [_] I DO NOT control a BBS and will not upload purchased software to
  4124. any BBS.
  4125. ------------------------------------------QTY---PRICE----TOTAL---
  4126. ___GDS Program and Documentation          ___  $39.95  $_________
  4127.  
  4128.            Shipping and Handling          _1_   $3.00  $_____3.00
  4129.  
  4130. ___*Picture Factory for Windows (10% off!)___  $44.95  $_________
  4131.    (2,659 full color photos on CD-ROM)
  4132.  
  4133. ___*Faster shipping (2-day UPS BLUE/48 States)  $5.00  $_________
  4134.  
  4135. ___International Shipping (call for shipping charge)   $_________
  4136.    NOTE: Foreign (non-US) check orders are not accepted.
  4137.  
  4138. __VISA __MasterCard __CHECK ENCL.  (8.25% CA Sales Tax)$_________
  4139. -----------------------------------------------------------------
  4140. ________/________/________/________ Ex:____/____  TOTAL$
  4141.                                                         =========
  4142. Sign:X___________________________*Ship FED/X #:__________________
  4143.  
  4144.       ORDERS VIA MAIL                 VISA/MC ORDERS VIA FAX
  4145.   Enclose check and mail to:      Fill out completely and FAX to:
  4146.                                        +--------------------+
  4147.     Photodex Corporation               |(510) 449-3519 - FAX|
  4148.     1781 Barcelona Street              +--------------------+
  4149.     Livermore, CA  94550               (510) 449-9079 - voice
  4150. :::hlConf
  4151. GDS VIDEO MODE CONFIGURATION
  4152.  
  4153. For help with this help message, press hlHelpF1] now.
  4154.  
  4155. Welcome to GDS's Video Configuration.  If this is the first time you have
  4156. configured GDS, then we recommend you take a minute or two to read about the
  4157. configuration process before you begin.
  4158.  
  4159.     hlConfTopUnderstanding GDS Configuration  <-- Click for more
  4160.     hlConfPUPower User Quick-Start    <-- Power User's Click Here
  4161.  
  4162. If you are ready to continue, select the message below.
  4163.  
  4164.     kCrStart Configuration    <-- Select to Start Configuration
  4165.  
  4166. :::hlConfTop
  4167. Configuration Help
  4168.  
  4169. The GDS Configuration process tests all available video modes for proper
  4170. operation.  Thanks to the this process, GDS does not suffer from the most
  4171. common problems other DOS graphics programs exhibit.
  4172.  
  4173. If you have trouble configuring GDS, call hlPhotodex(510) 449-9079 for technical help.
  4174. If you FAX us at hlPhotodex(510) 449-3519, we will respond as fast as possible.
  4175.  
  4176.     hlConfPUPower User Quick-Start
  4177.  
  4178. Helpful Information
  4179.     hlConfInstHow To Configure GDS
  4180.     hlConfTestHow Each Mode is Tested
  4181.     hlConfFileGDS Configuration Files
  4182.  
  4183. Common Problems
  4184.     hlConfVideoVESA, Mode Types, Missing Modes
  4185.     hlConfReptRepeated Configurations
  4186.     hlConfCrashCrashing Video Modes
  4187.     hlConfQuirksConfiguration Quirks
  4188.     hlConfLaptopCommon Laptop/Notebook Problems
  4189.  
  4190. :::hlConfLaptop
  4191. Common Laptop/Notebook Problems
  4192.  
  4193. Many laptop and notebook computers have Cirrus Logic chipsets which GDS does
  4194. not detect.  Try using /CL54 on the command line.
  4195.  
  4196. Some laptop and notebook computers crash when GDS tries to bring up the
  4197. configuration because of incompatibility with very old CGA and EGA modes.  If
  4198. you have a laptop, try using the following switches:
  4199. 
  4200.   /LAPTOP   Disable Herc, CGA and EGA (same as /NOHERC /NOCGA /NOEGA)
  4201. 
  4202.   /NOHERC   Disable Hercules monochrome mode
  4203.   /NOCGA    Disable all CGA modes
  4204.   /NOEGA    Disable all EGA modes
  4205. 
  4206.   /NOMONO   Disable all monochrome modes
  4207. :::hlConfVideo
  4208. VESA, Mode Types & Missing Modes
  4209.  
  4210. GDS supports four types of graphics modes: standard video modes, tweeked VGA
  4211. modes, VESA modes and other non-standard modes.  Standard modes work on all
  4212. VGA cards.  Many video provide VESA support, although we have NEVER seen a
  4213. complete VESA implementation, and some video cards require the user to load
  4214. VESA drivers in order to actually use the modes.  Most VESA cards work well
  4215. enough for GDS to be able to reliably detect and support the available video
  4216. modes.
  4217.  
  4218. If you have a VESA video card and GDS is not recognizing one or more of the
  4219. video modes that the card is supposed to be able to support, you may need to
  4220. load a VESA driver.  In particular, Diamond video cards seem to have the most
  4221. problems with graphics software, including programs like CSHOW.
  4222.  
  4223. You can usually get a VESA driver from your video card or computer
  4224. manufacturer.  Many video cards include a software program which supports
  4225. VESA when the video card does not support VESA by itself.
  4226.  
  4227. There are several VESA drivers available on local BBS systems, CompuServe,
  4228. America Online and GEnie, such as UniVESA (UVBE*.ZIP).  UniVESA has been
  4229. reported to us to cause incomplete VESA support and some compatibility
  4230. problems after running Windows with some video cards.  We have been unable
  4231. to determine the extent of UniVESA's support except that it works well for
  4232. some video systems.
  4233.  
  4234. Standard Modes:
  4235.   Hercules 720x348 (Monochrome)
  4236.   CGA      640x200 (Monochrome)
  4237.        320x200 (4 color)
  4238.   EGA       320x200, 640x200, 640x350 (16 color)
  4239.   VGA       640x480 (Monochrome)
  4240.        640x480 (16 color)
  4241.        320x200 (256 color)
  4242.  
  4243. Tweeked VGA Modes:
  4244.   VGA       320x240, 320x400, 360x480 (256 color)
  4245.  
  4246. VESA Modes
  4247.   VESA       800x600, 1024x768, 1280x1024 (16 color)
  4248.        640x400, 640x480, 800x600, 1024x768, 1280x1024 (256 color)
  4249.        320x200, 640x480, 800x600, 1024x768, 1280x1024 (32768 colors)
  4250.        320x200, 640x480, 800x600, 1024x768, 1280x1024 (65536 colors)
  4251.        320x200, 640x480, 800x600, 1024x768, 1280x1024 (16 million colors)
  4252.  
  4253. Other Non-Standard Modes:
  4254.   These modes occur on video cards that are detected to have specific support
  4255.   capabilities, and the list is really long.  If you are interested, please
  4256.   refer to the end of the GDS.TXT file, which should give you a lot of
  4257.   information about video modes.
  4258.  
  4259. Related Topics
  4260.     hlConfDiamondDiamond Video Cards
  4261.     hlConfOrchidOrchid Video Cards
  4262.     hlConfATIATI Video Cards (Mach 32)
  4263.  
  4264. :::hlConfFile
  4265. GDS Configuration Files
  4266.  
  4267. GDS configures runtime defaults using configuration files called GDSUSER.CFG
  4268. and GDSLOCAL.CFG.
  4269.  
  4270. GDSUSER.CFG is the main configuration file for GDS.  Any command line
  4271. parameter GDS is capable of taking can be placed in GDSUSER.CFG by specifying
  4272. the parameter on a line preceeded by "auto,".  For example,
  4273. 
  4274.     ------- (top of GDSUSER.CFG)
  4275. 
  4276.     auto,/QUIET        ;this line disables the opening screen
  4277. 
  4278.     ------- (bottom of GDSUSER.CFG)
  4279.  
  4280. You can also put more than one command line parameter per line, as follows:
  4281. 
  4282.     auto,/QUIET /A0        ;this line disables the opening screen and
  4283.                 ;disables antialiasing
  4284.  
  4285. Any semicolon (';') on a line in a configuration file tells GDS to ignore
  4286. everything following the semicolon.  This is handy to remove configuration
  4287. options temporarily without deleting the lines:
  4288. 
  4289.     ;auto,/QUIET /A0    ;this line now does nothing
  4290.  
  4291. Semicolons are great for adding comments to configuration lines (as in the
  4292. above examples.)  These Semicolons are sometimes called "comment characters."
  4293. You can use comment character to help you switch quickly between differing
  4294. configurations, as in the following example:
  4295. 
  4296.     auto,/#LPT1 /~J0    ;use the monochrome laser printer
  4297.     ;auto,/#LPT2 /~J1    ;use the color inkjet printer
  4298.  
  4299. With these two lines, you can switch between two printers by just moving the
  4300. semicolons, and commenting out alternate lines:
  4301. 
  4302.     ;auto,/#LPT1 /~J0    ;use the monochrome laser printer
  4303.     auto,/#LPT2 /~J1    ;use the color inkjet printer
  4304.  
  4305. The first example above would print using a monochrome laser printer on LPT1.
  4306. The second example would support a color inkjet printer on LPT2.
  4307.  
  4308. It may be useful to just put a general comment in the file, which you can do
  4309. like this:
  4310. 
  4311. ;These lines are just ignored
  4312. ;by GDS when it starts up, and
  4313. ;it doesn't really waste any time
  4314. ;at startup.
  4315.  
  4316. When GDS starts up, it searches first for video mode information, then for
  4317. GDSUSER.CFG, and finally for GDSLOCAL.CFG.  When the same parameter is
  4318. encountered more than once, the last parameter takes precedence.
  4319. GDSLOCAL.CFG has the "last say" for which parameters are actually used.  It
  4320. is common to have configuration options in GDSLOCAL.CFG which override the
  4321. parameters in GDSUSER.CFG.
  4322.  
  4323. GDS searches for these files by first looking in the directory that DOS was
  4324. logged to when GDS was invoked.  This is not necessarily the directory that
  4325. GDS is stored in.  You can completely replace GDSUSER or GDSLOCAL by starting
  4326. GDS in a directory which contains GDSUSER.CFG and/or GDSLOCAL.CFG
  4327.  
  4328. If a configuration file does not exist in the startup directory, then GDS
  4329. searches the directory containing GDS.  If the file still cannot be found,
  4330. GDS quietly assumes that it doesn't exist.  This is a slick way to force GDS
  4331. to use only the static runtime defaults shipped with the program.
  4332.  
  4333. Organizations cataloging hundreds (and thousands) of files find it invaluable
  4334. to use GDSLOCAL.CFG to store the command line parameters for the catalog
  4335. creation.  This way, they can just start GDS from the directory containing the
  4336. file and let GDS go.
  4337.  
  4338. Related Topics
  4339.     hlHowToCLCatalogCatalogs from the Command Line
  4340.  
  4341.  
  4342. :::hlConfTest
  4343. How Each Video Mode is Tested
  4344.  
  4345. GDS performs the following tests to see if a mode works:
  4346.  
  4347. 1) Set the video mode using standard BIOS INT 10h.
  4348.  
  4349. 2) Checks several VGA registers to see if the video hardware looks as if it
  4350.    is generating graphics rather than text.
  4351.  
  4352. 3) Checks the bank selection and determines how the bank selection should be
  4353.    carried out.  Note that many VESA BIOSes have bugs in the bank selection,
  4354.    which prevents some modes from being allowable by GDS.
  4355.  
  4356. If ANY Of these automatic tests fails, GDS assumes that the mode cannot work
  4357. properly, and the mode is thrown away.  On several cards, there are runs of
  4358. modes which do not pass these tests, causing slight flicker on the screen
  4359. as GDS throws the modes away.
  4360.  
  4361. The raw technicalities of how GDS checks for these things is beyond the scope
  4362. of this text.
  4363.  
  4364.  
  4365. :::hlConfInst
  4366. How to Configure GDS
  4367.  
  4368. In order to ensure that each video mode is supported by GDS, each mode must be
  4369. tested by GDS and approved by you.  This process ensures that when GDS shows
  4370. a picture, you see it properly.
  4371.  
  4372. GDS sets each mode and analyzes it to determine if it is functioning properly.
  4373. For more information about the technical attributes of the test, see hlConfTestHow Each
  4374. hlConfTestMode is Tested.
  4375.  
  4376. You may want to read the section called hlConfQuirksConfiguration Quirks section
  4377. for help with quirky setups with some specific video hardware.
  4378.  
  4379. The configuration process is simple:
  4380.  
  4381. 1) GDS draws a test pattern for each screen mode and allows you to type [Y] or
  4382.    [N] for "Yes" or "No".  If a mode looks ok, then press [Y] after you hear
  4383.    the beep.
  4384.  
  4385.    If there's no beep for 15-20 seconds, the machine has crashed.  See
  4386.    hlConfCrashCrashing Modes.
  4387.  
  4388.    If the mode looks good, press [Y].  If not, see hlConfBadModeBad Looking Modes.
  4389.  
  4390. 2) When you press [Y] or [N], GDS immediately continues on to the next mode.
  4391.    This allows you to type [Y] over and over again to whiz through the
  4392.    configuration.  It is not a good idea to type [Y] before you hear the beep.
  4393.  
  4394. 3) The monitor may not be able to synchronize to all of the modes tested.  If
  4395.    the video card is capable of higher resolution modes than the monitor
  4396.    supports, then the screen may scroll in various directions, shear, move
  4397.    around and flicker.
  4398.  
  4399.    Check the utilities which come with your video card.  Some cards support
  4400.    lower resolution monitors by supporting interlaced video modes.  Older
  4401.    video cards may need to have switches set in order to support interlaced
  4402.    monitors.
  4403.  
  4404. 4) The screen may flicker between modes if GDS finds modes that your card
  4405.    does not support.  This behavior is normal.
  4406.  
  4407.    If this happens, just hit [N] when you hear the beep because the screen is
  4408.    "NOT OK TO USE".
  4409.  
  4410. When the video modes have all been approved, GDS prompts you to save the
  4411. configuration file.  It is best to save it by pressing [Enter] so you don't
  4412. have to go through the process again.
  4413.  
  4414.  
  4415. :::hlConfQuirks
  4416. Configuration Quirks
  4417.  
  4418.     hlConfDiamondDiamond Video Cards
  4419.     hlConfOrchidOrchid Video Cards
  4420.     hlConfATIATI Video Cards (Mach 32)
  4421.  
  4422. :::hlConfATI
  4423. ATI Video Cards
  4424.  
  4425. ATI video cards are known to have some problems operating in high resolution
  4426. modes because of the timing of the video RAM.  If you see flickering lines in
  4427. a display, try setting the monitor's refresh rate to a slower rate.
  4428.  
  4429. If you have any problems with this description, call ATI at (905)882-2626.
  4430. They are familiar with the problems described here, and have been helpful.
  4431. 
  4432. ATI Mach 32
  4433.     First, you must run the INSTALL program included with the ATI Mach
  4434.     32 card.  This is located on Disk 1 of 3 in the packaging.  You
  4435.     should set the startup parameters for the type of monitor you have.
  4436.     We found it most useful to use 'Customer Monitor' so we could center
  4437.     each screen mode properly (which does not work reliably, but is
  4438.     better than nothing).  When complete, the INSTALL software reboots
  4439.     your machine.
  4440.  
  4441.     Note also here that the 1280x1024x768 mode seems to be sensitive to
  4442.     the scan rate shown at the top of the screen.  If you have problems
  4443.     with this mode, go back to the install and try to use a lower scan
  4444.     rate for this mode.  (Remember to delete CONFIG again so GDS will
  4445.     reconfigure itself!)
  4446.  
  4447.     Next, add VVESA to your AUTOEXEC.BAT file.  If you do not know how
  4448.     to do this, then call ATI at the above number.  Optionally, you can
  4449.     load VVESA before you run GDS, but that's a hassle.
  4450.  
  4451.     VVESA is the ONLY support that ATI has provided for SVGA modes in
  4452.     the Mach 32 card.  For more information on this limitation, call
  4453.     ATI at the above number.
  4454.  
  4455. ATI Mach 64
  4456.     GDS automatically detects the Mach 64 and appears to run flawlessly.
  4457.     ATI appears to have overcome many problems they had with the Mach 32
  4458.     when they produced the Mach 64.  Kudos to ATI for this solid and
  4459.     very capable SVGA system.
  4460. :::hlConfOrchid
  4461. Orchid Video Cards
  4462.  
  4463. Orchid has produced many cards with BIOS bugs.  Read the section below which
  4464. matches your video card.
  4465.  
  4466. Orchid Farenheit 1280
  4467.     GDS automatically detects the Farenheit 1280 and tries to work around
  4468.     the problems with the video BIOS.
  4469.  
  4470.     If you are having problems with the F1280, call Orchid and ask for a
  4471.     BIOS upgrade.  Make sure that they check the version number of the
  4472.     BIOS with the version number printed on the BIOS chip in your card so
  4473.     everyone knows if there is a BIOS update available or not.  Some
  4474.     Photodex customers with Orchid cards have been told that there is no
  4475.     update when there was.
  4476.  
  4477. Orchid Kelvin
  4478.     GDS should work properly with this card, but there have been some
  4479.     reports of problems.  If you encounter trouble, please hlPhotodexcall.
  4480.  
  4481. :::hlConfDiamond
  4482. Diamond Video Cards
  4483.  
  4484. Diamond Computers has produced many cards with BIOS bugs.  Read the section
  4485. below which matches your video card.
  4486.  
  4487. Diamond Stealth
  4488.     GDS automatically detects the Stealth and tries to work around most
  4489.     of the problems with the Stealth.  There are known problems with the
  4490.     1280x960x16 and 1280x1024x16 modes.  They almost work, but not all of
  4491.     the graphics data is displayed in these modes.  Unfortunately, there
  4492.     is nothing GDS can do about the BIOS bugs with these two modes.
  4493.  
  4494.     Make sure you have run STLMODE before running GDS, or VESA will not
  4495.     work and may crash your machine.  We recommend adding the following
  4496.     line to your AUTOEXEC.BAT file:
  4497. 
  4498.         STLMODE VESA
  4499.  
  4500. Diamond Stealth Pro
  4501.     GDS automatically detects the Stealth and tries to work around most
  4502.     of the problems with the Stealth Pro.
  4503.  
  4504.     Make sure you have run STLMODE before running GDS, or VESA will not
  4505.     work and may crash your machine.  We recommend adding the following
  4506.     line to your AUTOEXEC.BAT file:
  4507. 
  4508.         STLMODE VESA
  4509.  
  4510. Diamond Stealth 64
  4511.     GDS automatically detects the Stealth 64 and tries to work around
  4512.     most of the problems with the Stealth 64.
  4513.  
  4514.     Make sure you have run S64MODE before running GDS.  Refer to the
  4515.     documentation that came with the card.  If you have trouble, contact
  4516.     Diamond Computers.
  4517.  
  4518. Diamond Viper VLB/PCI
  4519.     Make sure you have run VPRMODE before running GDS, or VESA will not
  4520.     work and may crash your machine.  We recommend adding the following
  4521.     line to your AUTOEXEC.BAT file:
  4522. 
  4523.         VPRMODE VESA
  4524.  
  4525. :::hlConfBadMode
  4526. Bad Looking Modes
  4527.  
  4528. Sometimes, GDS will try to display a test screen and give the beep because it
  4529. wants to know what you think of the current mode.  The only problem is that
  4530. the mode doesn't work right.
  4531.  
  4532. There are several reasons why modes don't work ok.  Some are correctable and
  4533. some are not.  Use the following list to determine what to do after you hear
  4534. the beep, but are not satisfied with the test pattern:
  4535. 
  4536.   If you've heard a beep, but see one of the following:
  4537. 
  4538.     Nothing:    The mode is dead, type [N] to kill the mode and
  4539.             continue.
  4540.  
  4541.     Moving Junk:    The monitor can't sync to the mode.  Type [N] quickly
  4542.             to kill the mode and continue.
  4543.  
  4544.     Solid Junk:    If the screen is not jumping or moving around, the
  4545.             mode may be correctable.  Try to use the left and
  4546.             right arrow keys to adjust the skew (number of
  4547.             logical bytes per line).  If this works, the video
  4548.             card's BIOS may have bugs in the VESA support.
  4549.  
  4550.     Squished Left:    If the screen looks scrunched a bit to the left and
  4551.             has color artifacts, but is generally greenish or
  4552.             gray, the mode may be an improperly reported 32bpp
  4553.             24 bit color mode.  Try typing '3' to try 32 bit
  4554.             mode, or '2' for 24 bit mode.
  4555.  
  4556.  
  4557. :::hlConfRept
  4558. Repeated Configurations
  4559.  
  4560. If GDS keeps putting you through the configuration every time you run GDS,
  4561. then remove the semicolon (';') before the following line in hlConfFileGDSUSER.CFG:
  4562. 
  4563.   auto,/ok    ;assume CONFIG file is ok
  4564. 
  4565. GDS checks the very beginning of the video BIOS to determine if the video
  4566. hardware has changed, and automatically reconfigures video modes when it has.
  4567. Some very recent video cards change the contents of the video BIOS, which
  4568. tricks GDS into thinking they are a new video card.  The "/OK" switch
  4569. prevents GDS from automatically reconfiguring the video modes because of a
  4570. video BIOS change.
  4571.  
  4572. If a BIOS change does occur, GDS prompts to allow you to reconfigure or not.
  4573.  
  4574. :::hlConfCrash
  4575. Crashing Modes
  4576.  
  4577. If GDS crashes immediately after starting the configuration process, try using
  4578. the hl/LAPTOP/LAPTOP command line parameter when running GDS.  If this does
  4579. not solve the problem, call hlPhotodexPhotodex for help.
  4580.  
  4581. IF YOU FIND A CRASHING MODE, call us and tell us.  If we know about it, we may
  4582. be able to fix the problem, or at least force GDS to not try that particular
  4583. mode with the particular card you have.
  4584.  
  4585. Sometimes video cards have such severe bugs that they can crash the entire
  4586. machine.  If the machine hangs for more than about 15-20 seconds with no
  4587. noticeable screen change, then the video BIOS has probably crashed the system.
  4588.  
  4589. The usual case is where the first few modes work ok, and then GDS attempts to
  4590. support an SVGA mode via the BIOS, which locks the machine.  You need to
  4591. identify the mode BEFORE the offending mode and delete it manually.
  4592.  
  4593. Follow these steps carefully to avoid a crashing mode:
  4594. 
  4595. 1) Start GDS again, and remember the resolution and number of bits displayed
  4596.    at the upper left of each screen as you type [Y] to accept it (or [N] to
  4597.    reject it.)  This should be a number like 640x480x256, or 1024x768x65536.
  4598.    When the machine locks up again, you will now know the mode just before
  4599.    the mode to be omitted.
  4600.  
  4601. 2) Reboot your machine.
  4602.  
  4603. 3) Start GDS again, and go through the modes until the test screen appears
  4604.    for the mode you've remembered from step 1.  Press [Enter] to force GDS
  4605.    into text mode.  This prevents GDS from trying to set any graphics modes.
  4606.  
  4607. *NOTE:    This text display shows the resolutions in the text window, but never
  4608.     attempts to actually set the mode.  Because of this, you are "blind"
  4609.     as to whether or not the mode actually works, but this allows you to
  4610.     skip over modes which do not work at all.
  4611.  
  4612. 4) Approve (or disapprove) the mode mentioned in step 1 by pressing [Y] to
  4613.    accept the mode (or [N] to reject it).
  4614.  
  4615. 5) The mode which has a problem will now appear displayed in the text window.
  4616.    Press [N] to omit the mode from the mode list.
  4617.  
  4618. 6) Now you should be looking at a new resolution that you haven't seen before,
  4619.    which is the mode AFTER the one which was causing the problem.  If you
  4620.    press [Enter], GDS will go into the graphics configuration mode again, and
  4621.    attempt to show you a test screen for the mode.
  4622.  
  4623. *NOTE:    BEWARE that video cards with bad modes may have more than one bad
  4624.     mode, and they could appear one after another.  If the machine locks
  4625.     up again, then you need to skip the modes as described above without
  4626.     going into graphics mode again.  Using steps 1-6, you can pop in and
  4627.     out of text and graphics (test screen) mode as much as you like.
  4628.  
  4629. :::hlConfPU
  4630. Power User's Configuration Quick-Start
  4631.  
  4632. The following points will save you as much time as possible, and assume that
  4633. you know basically what you're doing.  DO NOT take anything for granted or
  4634. assume that GDS is screwed up.  If you have a strange problem, try
  4635. hlPhotodexcalling before giving up.  We'd like to get your feedback.
  4636.  
  4637. 1) DO NOT hit [Esc] to exit the configuration because you're impatient.  A
  4638.    successful configuration usually takes 30-60 seconds to complete.
  4639.  
  4640. 2) When GDS beeps during configuration, it's waiting for a keystroke after
  4641.    displaying a screen.  Don't assume the machine has crashed until 15 seconds
  4642.    happens before a noticeable change is seen or beep is heard.  Some video
  4643.    cards take a long time to set some video modes.
  4644.  
  4645. 3) When GDS beeps, it means that the software believes that the current mode
  4646.    works, and GDS has drawn a valid test pattern.  If you see:
  4647.  
  4648.     Nothing:    The mode is dead, type [N] to kill the mode and
  4649.             continue.
  4650.  
  4651.     Moving Junk:    The monitor can't sync to the mode.  Type [N] quickly
  4652.             to kill the mode and continue.
  4653.  
  4654.     Solid Junk:    If the screen is not jumping around, the mode may
  4655.             be good.  Try to use the left and right arrow keys to
  4656.             adjust the skew (number of logical bytes per line).
  4657.             If this works, the VESA BIOS may have bugs.
  4658.  
  4659.     Almost Ok:    If the screen looks scrunched a bit to the left and
  4660.             has color artifacts but is generally greenish or gray,
  4661.             the mode may be an improperly reported 32bpp 24 bit
  4662.             color mode.  Try typing '3' to try 32 bit mode, or
  4663.             '2' for 24 bit mode.
  4664.  
  4665. 4) If a mode crashes the machine, refer to hlConfCrashCrashing Modes.
  4666.  
  4667. 5) Watch to see that 15, 16 and 24 bit modes have RED and BLUE correct in the
  4668.    upper left area of the screen.  Type [S] to swap RED and BLUE.
  4669.  
  4670. QUICK NOTE:  If you have a VESA compatible SVGA and GDS doesn't recognize all
  4671. of the modes the card is supposed to support, delete the file called "CONFIG"
  4672. and run GDS again by specifying hlCmdVH/VESA on the command line
  4673. (Type: GDS hlCmdVH/VESA).
  4674.  
  4675. Related Topics
  4676.     hlCmdVHVideo Hardware Parameters
  4677.     hlRevRevision History
  4678.  
  4679.  
  4680. :::hlHelp
  4681. Help With Help
  4682.  
  4683. You are using GDS's built-in hypertext help system.  Help is divided into
  4684. messages, which may contain text buttons which link to other help messages.
  4685. This help system is similar to the Windows help system.
  4686.  
  4687. To scroll the screen up and down, you can use the page and arrow keys, or move
  4688. the mouse to the top and bottom of the screen.
  4689.  
  4690. Text buttons are displayed in bright white, and can be selected by clicking on
  4691. them, or by using the [Tab] and [Enter] keys to switch buttons and finally
  4692. select one.
  4693.  
  4694. To exit a GDS help message, press the [Esc] key or click the mouse at the top
  4695. of the help screen.  Note that you can be into help several levels deep, so
  4696. exiting multiple help messages may be necessary to get all the way out of
  4697. help.
  4698.  
  4699.  
  4700.      [Up]    [PgUp]
  4701.             Scroll the screen (mouse works also)
  4702.     [Down]    [PgDn]
  4703. :::GDS.CFG
  4704. ;VIDEO CONFIGURATION FILE FORMAT:
  4705. ;
  4706. ;  This file was created to support GDS.  It is also a great reference
  4707. ;  of most video modes supported on a lot of cards, but in no way is a
  4708. ;  "complete" or fully tested list.  Use this list at your own risk.
  4709. ;  If you use this list in software, please give Paul Schmidt credit
  4710. ;  for the effort of creating this list.  It's a lot of work.  The
  4711. ;  author assumes no responsibility for the accuracy of this list.
  4712. ;
  4713. ;  If you discover errors, ommissions, or have suggestions, please
  4714. ;  contact Photodex and specifically reference the GDS.CFG file.
  4715. ;
  4716.  
  4717. ;NOTE:  Any ';' will cause GDS to ignore to the end of the line.
  4718. ;       If a video mode is giving you problems, you can disable it
  4719. ;       by inserting a ';' in front of the line which describes it.
  4720.  
  4721. ;Argument Definitions
  4722. ;<name> is the name of the video display (7 characters MAXIMUM)
  4723. ;<hRes> and <vRes> are the screen resolution
  4724. ;<bpix> is the number of bits per pixel
  4725. ;<ax>, <bx>, <cx>, and <dx> are the processor registers on a call to
  4726. ;           "int 010h" unless <directFlag> is non-zero
  4727. ;<dirct> indicates the base address for text modes, and tells if
  4728. ;           the graphics mode should be initialized by directly
  4729. ;           accessing the VGA registers. (0, 1, or text base address)
  4730. ;           
  4731. ;<format> dictates the screen format (0 is normal, 1 is chunky 4-bit)
  4732. ;
  4733. ;<name>    <hRes>    <vRes>    <bpix>    <ax>    <bx>    <cx>    <dx>    <dirct>    <dotMode>
  4734.  
  4735. ;dot modes:
  4736. ;    0 = standard planar 16 or bytewide 256 color mapping
  4737. ;    1 = 4 bit chunky
  4738. ;    2 = planar 256 color (tweeked VGA modes)
  4739. ;    3 = TIGA modes (automatically detected)
  4740. ;    5 = Sierra Hi-Color DAC (32,768 colors)
  4741. ;        NOTE: Sierra DAC Hi-Color modes are automatically queried for
  4742. ;        BIOS support if the <ax> value is set to 0x10f0.  If you know
  4743. ;        the mode number of a Hi-Color mode for your card, you may set
  4744. ;        the values of the <ax> and <bx> registers to something
  4745. ;        other than 0x10f0, and GDS will assume the mode is supported.
  4746. ;    6 = RESERVED (DO NOT USE THIS)
  4747. ;    7 = Hercules monochrome
  4748. ;    8 = CGA monochrome
  4749. ;    9 = 4 bit chunky reverse order (BARF)
  4750. ;    10 = 24 bit DAC (16M colors) Standard order: RGB
  4751. ;        NOTE: Some 24 bit DAC modes are automatically queried for
  4752. ;        BIOS support if the <ax> value is set to 0x10e0.  If you know
  4753. ;        the mode number of a 24 bit mode for your card, you may set
  4754. ;        the values of the <ax> and <bx> registers to something
  4755. ;        other than 0x10e0, and GDS will assume the mode is supported.
  4756. ;    11 = 24 bit DAC (16M colors) Reverse order: BGR
  4757. ;    12 = 24 bit DAC (16M colors) Standard order: RGBX
  4758. ;        NOTE: Some 24 bit DAC modes are automatically queried for
  4759. ;        BIOS support if the <ax> value is set to 0x10e0.  If you know
  4760. ;        the mode number of a 24 bit mode for your card, you may set
  4761. ;        the values of the <ax> and <bx> registers to something
  4762. ;        other than 0x10e0, and GDS will assume the mode is supported.
  4763. ;    13 = 24 bit DAC (16M colors) Reverse order: BGRX
  4764.  
  4765. ;HERCULES
  4766. HERC,    720,    348,    1,    0,    0,    0,    0,    1,    7    ;hercules
  4767.  
  4768. ;STANDARD CGA
  4769. CGA,    640,    200,    1,    0x6,    0,    0,    0,    0,    8    ;CGA monochrome
  4770. CGA,    320,    200,    2,    0x4,    0,    0,    0,    0,    0
  4771.  
  4772. ;STANDARD EGA
  4773. EGA,    80,    25,    0,    0x3,    0,    0,    0,    0xb800,    0    ;default text mode
  4774. EGA,    320,    200,    4,    0xd,    0,    0,    0,    0,    0
  4775. EGA,    640,    200,    4,    0xe,    0,    0,    0,    0,    0
  4776. EGA,    640,    350,    4,    0x10,    0,    0,    0,    0,    0
  4777.  
  4778. ;STANDARD VGA
  4779. VGA,    640,    480,    1,    0x11,    0,    0,    0,    0,    0
  4780. VGA,    640,    480,    4,    0x12,   0,    0,    0,    0,    0
  4781. VGA,    320,    200,    8,    0x13,    0,    0,    0,    0,    0
  4782.  
  4783. ;NON-STANDARD VGA (FOR REGISTER COMPATIBLE VGA CARDS ONLY!!!)
  4784. VGA,    320,    240,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
  4785. VGA,    320,    400,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
  4786. VGA,    360,    480,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
  4787. ;VGA,    704,    528,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4788. ;VGA,    720,    540,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4789. ;VGA,    736,    552,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4790. ;VGA,    752,    564,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4791. ;VGA,    768,    576,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4792. ;VGA,    784,    588,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4793. ;VGA,    800,    600,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
  4794. ;VGA,    640,    400,    8,    0,    0,    0,    0,    1,    0    ;works with some register compatible VGAs!
  4795. ;   NOTE: If you'd like to use these modes (and you have a registered
  4796. ;    version), we strongly recommended that you move these definitions
  4797. ;    into GDSUSER.CFG and remove the semicolons (';').  This will prevent
  4798. ;    new versions from overwriting your preferences.  Unregistered
  4799. ;    versions of GDS do not read GDSUSER.CFG.
  4800.  
  4801. ;AHEAD SYSTEMS
  4802. AHEAD,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  4803. AHEAD,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
  4804. AHEAD,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
  4805. AHEAD,    160,    50,    0,    0x2f,    0,    0,    0,    0xb800,    0
  4806. AHEAD,    80,    66,    0,    0x34,    0,    0,    0,    0xb800,    0
  4807. AHEAD,    1024,    768,    2,    0x75,    0,    0,    0,    0,    0
  4808. AHEAD,    640,    400,    8,    0x60,    0,    0,    0,    0,    0
  4809. AHEAD,    640,    480,    8,    0x61,    0,    0,    0,    0,    0
  4810. AHEAD,    800,    600,    8,    0x62,    0,    0,    0,    0,    0
  4811.  
  4812. ;AHEAD SYSTEMS
  4813. AHEADB,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  4814. ;AHEADB, 132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0    ;not on all cards
  4815. AHEADB,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
  4816. ;AHEADB, 160,    50,    0,    0x2f,    0,    0,    0,    0xb800,    0    ;not on all cards
  4817. ;AHEADB, 80,    66,    0,    0x34,    0,    0,    0,    0xb800,    0    ;not on all cards
  4818. AHEADB,    1024,    768,    2,    0x75,    0,    0,    0,    0,    0
  4819. AHEADB,    800,    600,    4,    0x6a,    0,    0,    0,    0,    0
  4820. AHEADB,    1024,    768,    4,    0x74,    0,    0,    0,    0,    0
  4821. AHEADB,    640,    400,    8,    0x60,    0,    0,    0,    0,    0
  4822. AHEADB,    640,    480,    8,    0x61,    0,    0,    0,    0,    0
  4823. AHEADB,    800,    600,    8,    0x62,    0,    0,    0,    0,    0
  4824. AHEADB,    1024,    768,    8,    0x63,    0,    0,    0,    0,    0
  4825.  
  4826. ;ATI Wonder
  4827. ATI,    80,    30,    0,    0x5b,    0,    0,    0,    0xb800,    0
  4828. ATI,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  4829. ATI,    132,    44,    0,    0x33,    0,    0,    0,    0xb800,    0
  4830. ATI,    1024,    768,    2,    0x67,   0,    0,    0,    0,    1
  4831. ATI,    800,    600,    4,    0x54,   0,    0,    0,    0,    0
  4832. ;ATI,    1024,    768,    4,    0x55,   0,    0,    0,    0,    0    ;bank selection for video reads
  4833.                                         ;doesn't seem to work properly in
  4834. ;ATI,    1024,    768,    4,    0x65,   0,    0,    0,    0,    1
  4835. ATI,    640,    400,    8,    0x61,    0,    0,    0,    0,    0
  4836. ATI,    640,    480,    8,    0x62,    0,    0,    0,    0,    0
  4837. ATI,    800,    600,    8,    0x63,    0,    0,    0,    0,    0
  4838. ATI,    1024,    768,    8,    0x64,   0,    0,    0,    0,    0
  4839. ATI,    640,    480,    15,    0x72,    0,    0,    0,    0,    5
  4840.  
  4841. ;CHIPS & TECHNOLOGIES
  4842. CHIPS,    132,    25,    0,    0x60,    0,    0,    0,    0xb800,    0
  4843. CHIPS,    132,    50,    0,    0x61,    0,    0,    0,    0xb800,    0
  4844. CHIPS,    800,    600,    4,    0x70,    0,    0,    0,    0,    0
  4845. CHIPS,    1024,    768,    4,    0x72,    0,    0,    0,    0,    0
  4846. CHIPS,    640,    400,    8,    0x78,    0,    0,    0,    0,    0
  4847. CHIPS,    640,    480,    8,    0x79,    0,    0,    0,    0,    0
  4848. CHIPS,    768,    576,    8,    0x7a,    0,    0,    0,    0,    0
  4849. CHIPS,    800,    600,    8,    0x7b,    0,    0,    0,    0,    0
  4850.  
  4851. ;CIRRUS 510,520 - MaxLogic MaxVGA
  4852. CIRRUS,    132,    25,    0,    0x1f,    0,    0,    0,    0xb800,    0
  4853. CIRRUS,    132,    30,    0,    0x22,    0,    0,    0,    0xb800,    0
  4854. CIRRUS,    132,    44,    0,    0x20,    0,    0,    0,    0xb800,    0
  4855. CIRRUS,    720,    540,    4,    0x40,    0,    0,    0,    0,    0
  4856. CIRRUS,    800,    600,    4,    0x6a,    0,    0,    0,    0,    0
  4857. CIRRUS,    640,    400,    8,    0x50,    0,    0,    0,    0,    2
  4858. ;CIRRUS, 512,    480,    8,    0x51,    0,    0,    0,    0,    0    ;NOTE: use only with the TSR BIOS extension!
  4859.  
  4860. ;CL54 54xx - Cirrus Logic SVGA Chips
  4861. CL54,    132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
  4862. CL54,    132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
  4863. CL54,    132,    60,    0,    0x53,    0,    0,    0,    0xb800,    0    ;if you're brave
  4864. CL54,    800,    600,    4,    0x58,    0,    0,    0,    0,    0
  4865. CL54,    1024,    768,    4,    0x5d,    0,    0,    0,    0,    0
  4866. CL54,    1280,    1024,    4,    0x6c,    0,    0,    0,    0,    0
  4867. CL54,    640,    480,    8,    0x5f,    0,    0,    0,    0,    0
  4868. CL54,    800,    600,    8,    0x5c,    0,    0,    0,    0,    0
  4869. CL54,    1024,    768,    8,    0x60,    0,    0,    0,    0,    0
  4870. CL54,    1280,    1024,    8,    0x6d,    0,    0,    0,    0,    0
  4871. CL54,    640,    480,    15,    0x66,    0,    0,    0,    0,    5
  4872. CL54,    800,    600,    15,    0x67,    0,    0,    0,    0,    5
  4873. CL54,    640,    480,    16,    0x64,    0,    0,    0,    0,    0
  4874. CL54,    800,    600,    16,    0x65,    0,    0,    0,    0,    0
  4875. CL54,    1024,    768,    16,    0x74,    0,    0,    2048,    0,    0
  4876. CL54,    320,    200,    24,    0x70,    0,    0,    2048,    0,    11
  4877. CL54,    640,    480,    24,    0x71,    0,    0,    2048,    0,    11
  4878.  
  4879. ;EVEREX
  4880. EVEREX,    800,    600,    4,    0x70,    0x02,    0,    0,    0,    0
  4881. EVEREX,    640,    350,    8,    0x70,    0x13,    0,    0,    0,    0
  4882. EVEREX,    640,    400,    8,    0x70,    0x14,    0,    0,    0,    0
  4883. EVEREX,    512,    480,    8,    0x70,    0x15,    0,    0,    0,    0
  4884. EVEREX,    640,    480,    8,    0x70,    0x30,    0,    0,    0,    0
  4885. EVEREX,    800,    600,    8,    0x70,    0x31,    0,    0,    0,    0
  4886.  
  4887. ;EV634 - EVEREX Viewpoint Premium VGA (EV-634)
  4888. EV634,    80,    30,    0,    0x70,    0x16,    0,    0,    0xb800,    0
  4889. EV634,    80,    34,    0,    0x70,    0x03,    0,    0,    0xb800,    0
  4890. EV634,    80,    60,    0,    0x70,    0x04,    0,    0,    0xb800,    0
  4891. EV634,    100,    37,    0,    0x70,    0x18,    0,    0,    0xb800,    0
  4892. EV634,    100,    43,    0,    0x70,    0x07,    0,    0,    0xb800,    0
  4893. EV634,    100,    75,    0,    0x70,    0x08,    0,    0,    0xb800,    0
  4894. EV634,    132,    25,    0,    0x70,    0x0a,    0,    0,    0xb800,    0
  4895. EV634,    132,    30,    0,    0x70,    0x40,    0,    0,    0xb800,    0
  4896. EV634,    132,    44,    0,    0x70,    0x0b,    0,    0,    0xb800,    0
  4897. EV634,    1024,    768,    2,    0x70,    0x60,    0,    0,    0,    0    ;this mode seems to exist only in the documentation...
  4898. EV634,    800,    600,    4,    0x70,    0x02,    0,    0,    0,    0
  4899. EV634,    1024,    768,    4,    0x70,    0x20,    0,    0,    0,    0
  4900. EV634,    1280,    1024,    4,    0x70,    0x21,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  4901. EV634,    1664,    1200,    4,    0x70,    0x23,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  4902. EV634,    640,    400,    8,    0x70,    0x14,    0,    0,    0,    0
  4903. EV634,    512,    480,    8,    0x70,    0x15,    0,    0,    0,    0
  4904. EV634,    640,    480,    8,    0x70,    0x30,    0,    0,    0,    0
  4905. EV634,    800,    600,    8,    0x70,    0x31,    0,    0,    0,    0
  4906. EV634,    1024,    768,    8,    0x70,    0x32,    0,    0,    0,    0
  4907. EV634,    320,    200,    15,    0x70,    0x62,    0,    0,    0,    5
  4908. EV634,    512,    480,    15,    0x70,    0x70,    0,    0,    0,    5
  4909. EV634,    640,    480,    15,    0x70,    0x71,    0,    0,    0,    5
  4910. EV634,    800,    600,    15,    0x70,    0x63,    0,    0,    0,    5
  4911.  
  4912. ;ORCHID Farenheit 1280 (S3)
  4913. F1280,    132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
  4914. F1280,    132,    44,    0,    0x54,    0,    0,    0,    0xb800,    0
  4915. F1280,    800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
  4916. F1280,    1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
  4917. F1280,    1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
  4918. F1280,    1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    1    ;NOTE: Way cool monitors only!
  4919. F1280,    640,    480,    8,    0x4f02,    0x201,    0,    1024,    0,    0
  4920. F1280,    800,    600,    8,    0x4f02,    0x203,    0,    1024,    0,    0
  4921. F1280,    1024,    768,    8,    0x4f02,    0x205,    0,    0,    0,    0
  4922. F1280,    640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5
  4923.  
  4924. ;GENOA 6000 series (6100, 6200, 6300, 6400, 6600)
  4925. ;      THANX: Herman, Steve, and Decker w/Genoa customer support
  4926. GENOA,    80,    32,    0,    0x58,    0,    0,    0,    0xb800,    0
  4927. GENOA,    80,    60,    0,    0x72,    0,    0,    0,    0xb800,    0
  4928. GENOA,    80,    66,    0,    0x74,    0,    0,    0,    0xb800,    0
  4929. GENOA,    100,    37,    0,    0x78,    0,    0,    0,    0xb800,    0
  4930. GENOA,    132,    25,    0,    0x60,    0,    0,    0,    0xb800,    0
  4931. GENOA,    132,    29,    0,    0x61,    0,    0,    0,    0xb800,    0
  4932. GENOA,    132,    32,    0,    0x62,    0,    0,    0,    0xb800,    0
  4933. GENOA,    132,    44,    0,    0x63,    0,    0,    0,    0xb800,    0
  4934. GENOA,    132,    60,    0,    0x64,    0,    0,    0,    0xb800,    0
  4935. GENOA,    1024,    768,    2,    0x7f,    0,    0,    0,    0,    0
  4936. GENOA,    800,    600,    4,    0x79,    0,    0,    0,    0,    0
  4937. GENOA,    1024,    768,    4,    0x5f,    0,    0,    0,    0,    0
  4938. GENOA,    640,    400,    8,    0x7e,    0,    0,    0,    0,    0
  4939. GENOA,    640,    480,    8,    0x5c,    0,    0,    0,    0,    0
  4940. GENOA,    800,    600,    8,    0x5e,    0,    0,    0,    0,    0
  4941. ;GENOA,    100,    75,    0,    0x79,    0,    0,    0,    0xb800,    0    ;I think these are dead modes from a
  4942. ;GENOA,    512,    512,    4,    0x7c,    0,    0,    0,    0,    0    ;   beta version of Genoa's BIOS
  4943. ;GENOA,    720,    512,    4,    0x59,    0,    0,    0,    0,    0
  4944. ;GENOA,    512,    512,    8,    0x7d,    0,    0,    0,    0,    0
  4945. ;GENOA,    640,    350,    8,    0x5b,    0,    0,    0,    0,    0
  4946. ;GENOA,    720,    512,    8,    0x5d,    0,    0,    0,    0,    0
  4947.  
  4948. ;OAKTECH
  4949. OAK,    132,    25,    0,    0x50,    0,    0,    0,    0xb800,    0
  4950. OAK,    132,    43,    0,    0x51,    0,    0,    0,    0xb800,    0
  4951. OAK,    132,    60,    0,    0x4f,    0,    0,    0,    0xb800,    0
  4952. OAK,    800,    600,    4,    0x52,    0,    0,    0,    0,    0
  4953. OAK,    1024,    768,    4,    0x56,    0,    0,    0,    0,    0
  4954. OAK,    640,    480,    8,    0x53,    0,    0,    0,    0,    0
  4955. OAK,    800,    600,    8,    0x54,    0,    0,    0,    0,    0
  4956.  
  4957. ;PARADISE (Paradise VGA 1024)
  4958. ;PARA,   800,    600,    8,      0x59,   0,      0,      0,      0,      0 ;Genoa 8500
  4959. ;PARA,  1024,    768,    8,      0x5a,   0,      0,      0,      0,      0 ;Genoa 8500
  4960. PARA,   132,    25,     0,      0x55,   0,      0,      0,      0,      0
  4961. PARA,   132,    43,     0,      0x54,   0,      0,      0,      0,      0
  4962. PARA,    800,    600,    1,    0x59,    0,    0,    0,    0,    0
  4963. PARA,    1024,    768,    1,    0x5a,    0,    0,    0,    0,    0    ;is SMT-1024 mode 0x5c for this?
  4964. PARA,    1024,    768,    2,    0x5b,    0,    0,    0,    0,    0    ;is SMT-1024 mode 0x5c for this?
  4965. PARA,   800,    600,    4,      0x58,   0,      0,      0,      0,      0
  4966. PARA,   1024,   768,    4,      0x5d,   0,      0,      0,      0,      0 ;is SMT-1024 mode 0x5c for this?
  4967. PARA,  1280,    960,    4,      0x6C,   0,      0,      0,      0,      0
  4968. PARA,  1280,   1024,    4,      0x64,   0,      0,      0,      0,      0
  4969. PARA,   640,    400,    8,      0x5e,   0,      0,      0,      0,      0
  4970. PARA,   640,    480,    8,      0x5f,   0,      0,      0,      0,      0
  4971. PARA,   800,    600,    8,      0x5c,   0,      0,      0,      0,      0
  4972. PARA,  1024,    768,    8,      0x60,   0,      0,      0,      0,      0
  4973. PARA,   640,    480,   15,      0x62,   0,      0,      0,      0,      5
  4974. PARA,   800,    600,   15,      0x63,   0,      0,      0,      0,      5
  4975. PARA,   640,    480,   24,      0x72,   0,      0,      0,      0,     10
  4976.  
  4977. ;Diamond Computer Speedstar 24X (*NOT* Speedstar 24)
  4978. SS24X,    80,    34,    0,    0x41,    0,    0,    0,    0,    0
  4979. SS24X,    80,    43,    0,    0x67,    0,    0,    0,    0,    0
  4980. SS24X,    80,    50,    0,    0x66,    0,    0,    0,    0,    0
  4981. SS24X,    132,    25,    0,    0x55,    0,    0,    0,    0,    0
  4982. SS24X,    132,    28,    0,    0x47,    0,    0,    0,    0,    0
  4983. SS24X,    132,    43,    0,    0x54,    0,    0,    0,    0,    0
  4984. SS24X,    132,    44,    0,    0x21,    0,    0,    0,    0,    0
  4985. SS24X,    132,    50,    0,    0x69,    0,    0,    0,    0,    0
  4986. SS24X,    800,    600,    4,    0x58,    0,    0,    0,    0,    0
  4987. SS24X,    1024,    768,    4,    0x5d,    0,    0,    0,    0,    0
  4988. SS24X,    1280,    960,    4,    0x6c,    0,    0,    0,    0,    0
  4989. SS24X,    1280,    1024,    4,    0x64,    0,    0,    0,    0,    0
  4990. SS24X,    640,    400,    8,    0x5e,    0,    0,    0,    0,    0
  4991. SS24X,    640,    480,    8,    0x5f,    0,    0,    0,    0,    0
  4992. SS24X,    800,    600,    8,    0x5c,    0,    0,    0,    0,    0
  4993. SS24X,    1024,    768,    8,    0x60,    0,    0,    0,    0,    0
  4994. SS24X,    640,    480,    15,    0x62,    0,    0,    0,    0,    5
  4995. SS24X,    800,    600,    15,    0x63,    0,    0,    0,    0,    5
  4996. SS24X,    640,    480,    24,    0x72,    0,    0,    0,    0,    10
  4997.  
  4998. ;Diamond Computer Stealth 64 (S3)
  4999. ST64,    640,    480,    24,    0x4f02,    0x112,    0,    4096,    0,    13
  5000. ST64,    800,    600,    24,    0x4f02,    0x115,    0,    4096,    0,    13
  5001. ST64,    1024,    768,    24,    0x4f02,    0x118,    0,    4096,    0,    13
  5002. ST64,    1152,    864,    24,    0x4f02,    0x20b,    0,    4608,    0,    13
  5003.                                      
  5004. ;Diamond Computer Stealth VRAM (S3)
  5005. STEALTH,132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
  5006. STEALTH,132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
  5007. STEALTH,800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
  5008. STEALTH,1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
  5009. STEALTH,1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
  5010. STEALTH,1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    9
  5011. STEALTH,640,    480,    8,    0x4f02,    0x101,    0,    640,    0,    0
  5012. STEALTH,800,    600,    8,    0x4f02,    0x103,    0,    1024,    0,    0
  5013. STEALTH,1024,    768,    8,    0x4f02,    0x105,    0,    0,    0,    0
  5014. STEALTH,640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5
  5015.  
  5016. ;Diamond Computer Stealth PRO (S3)
  5017. STPRO,132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
  5018. STPRO,132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
  5019. STPRO,800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
  5020. STPRO,1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
  5021. STPRO,1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
  5022. STPRO,1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    9
  5023. STPRO,640,    480,    8,    0x4f02,    0x201,    0,    1024,    0,    0
  5024. STPRO,800,    600,    8,    0x4f02,    0x203,    0,    1024,    0,    0
  5025. STPRO,1024,    768,    8,    0x4f02,    0x205,    0,    0,    0,    0
  5026. STPRO,1280,    1024,    8,    0x4f02,    0x107,    0,    0,    0,    0
  5027. STPRO,640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5
  5028. STPRO,640,    480,    16,    0x4f02,    0x211,    0,    2048,    0,    5
  5029. STPRO,800,    600,    16,    0x4f02,    0x114,    0,    0,    0,    5
  5030. STPRO,640,    480,    24,    0x4f02,    0x212,    0,    2048,    0,    10
  5031. STPRO,800,    600,    24,    0x4f02,    0x221,    0,    0,    0,    10
  5032.  
  5033. ;TRIDENT (Trident TVGA / ATI Prism Elite / Everex Viewpoint VGA)
  5034. TRIDNT,    80,    30,    0,    0x50,    0,    0,    0,    0xb800,    0
  5035. TRIDNT,    80,    43,    0,    0x51,    0,    0,    0,    0xb800,    0
  5036. TRIDNT,    80,    60,    0,    0x52,    0,    0,    0,    0xb800,    0
  5037. TRIDNT,    132,    25,    0,    0x53,    0,    0,    0,    0xb800,    0
  5038. TRIDNT,    132,    30,    0,    0x54,    0,    0,    0,    0xb800,    0
  5039. TRIDNT,    132,    43,    0,    0x55,    0,    0,    0,    0xb800,    0
  5040. TRIDNT,    132,    60,    0,    0x56,    0,    0,    0,    0xb800,    0
  5041. ;TRIDNT,132,    25,    0,    0x57,    0,    0,    0,    0xb800,    0    ;these four modes work, but
  5042. ;TRIDNT,132,    30,    0,    0x58,    0,    0,    0,    0xb800,    0    ;don't seem to be necessary.
  5043. ;TRIDNT,132,    43,    0,    0x59,    0,    0,    0,    0xb800,    0
  5044. ;TRIDNT,132,    60,    0,    0x5a,    0,    0,    0,    0xb800,    0
  5045. TRIDNT,    1024,    768,    2,    0x60,    0,    0,    0,    0,    0
  5046. ;TRIDNT, 768,    1024,    4,    0x61,    0,    0,    0,    0,    0    ;use portrait CRT ONLY!!! (Magics 15FP)
  5047. TRIDNT,    800,    600,    4,    0x5b,    0,    0,    0,    0,    0
  5048. TRIDNT,    1024,    768,    4,    0x5f,    0,    0,    0,    0,    0
  5049. TRIDNT,    640,    400,    8,    0x5c,    0,    0,    0,    0,    0
  5050. TRIDNT,    640,    480,    8,    0x5d,    0,    0,    0,    0,    0
  5051. TRIDNT,    800,    600,    8,    0x5e,    0,    0,    0,    0,    0
  5052. TRIDNT,    1024,    768,    8,    0x62,    0,    0,    0,    0,    0
  5053.  
  5054. ;TSENG LABS ET3000 (STB VGA EM-16)
  5055. TSENG,    80,    60,    0,    0x26,    0,    0,    0,    0xb800,    0
  5056. TSENG,    100,    40,    0,    0x2a,    0,    0,    0,    0xb800,    0
  5057. TSENG,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  5058. TSENG,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
  5059. TSENG,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
  5060. TSENG,    800,    600,    4,    0x29,    0,    0,    0,    0,    0
  5061. TSENG,    1024,    768,    4,    0x37,    0,    0,    0,    0,    0
  5062. TSENG,    640,    350,    8,    0x2d,    0,    0,    0,    0,    0
  5063. TSENG,    640,    480,    8,    0x2e,    0,    0,    0,    0,    0
  5064. TSENG,    720,    512,    8,    0x2f,    0,    0,    0,    0,    0
  5065. TSENG,    800,    600,    8,    0x30,    0,    0,    0,    0,    0
  5066.  
  5067. ;TSENG LABS ET4000
  5068. TSENG4,    80,    60,    0,    0x26,    0,    0,    0,    0xb800,    0
  5069. TSENG4,    100,    40,    0,    0x2a,    0,    0,    0,    0xb800,    0
  5070. TSENG4,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
  5071. TSENG4,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
  5072. TSENG4,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
  5073. TSENG4,    800,    600,    4,    0x29,    0,    0,    0,    0,    0
  5074. TSENG4,    1024,    768,    4,    0x37,    0,    0,    0,    0,    0
  5075. TSENG4,    640,    350,    8,    0x2d,    0,    0,    0,    0,    0
  5076. TSENG4,    640,    400,    8,    0x2f,    0,    0,    0,    0,    0
  5077. TSENG4,    640,    480,    8,    0x2e,    0,    0,    0,    0,    0
  5078. TSENG4,    800,    600,    8,    0x30,    0,    0,    0,    0,    0
  5079. TSENG4,    1024,    768,    8,    0x38,    0,    0,    0,    0,    0
  5080. TSENG4,    320,    200,    15,    0x10f0,    0x13,    0,    0,    0,    5    ;queried Sierra Hi-Color modes
  5081. TSENG4,    640,    350,    15,    0x10f0,    0x2d,    0,    0,    0,    5
  5082. TSENG4,    640,    400,    15,    0x10f0,    0x2f,    0,    0,    0,    5
  5083. TSENG4,    640,    480,    15,    0x10f0,    0x2e,    0,    0,    0,    5
  5084. TSENG4,    800,    600,    15,    0x10f0,    0x30,    0,    0,    0,    5
  5085. TSENG4,    320,    200,    15,    0x10f0,    0x13,    0,    0,    0,    5    ;queried Sierra Hi-Color modes
  5086. TSENG4,    640,    350,    15,    0x10f0,    0x2d,    0,    0,    0,    5
  5087. TSENG4,    640,    480,    24,    0x10e0,    0x2e,    0,    2048,    0,    10    ;queried 24 bit modes
  5088.  
  5089. ;VESA (assumes all modes are present, comment out modes here which don't exist)
  5090. VESA,    800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
  5091. VESA,    1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
  5092. VESA,    1280,    1024,    4,    0x4f02,    0x106,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  5093. VESA,    640,    400,    8,    0x4f02,    0x100,    0,    0,    0,    0
  5094. VESA,    640,    480,    8,    0x4f02,    0x101,    0,    0,    0,    0
  5095. VESA,    800,    600,    8,    0x4f02,    0x103,    0,    0,    0,    0
  5096. VESA,    1024,    768,    8,    0x4f02,    0x105,    0,    0,    0,    0
  5097. VESA,    1280,    1024,    8,    0x4f02,    0x107,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  5098. VESA,    320,    200,    15,    0x4f02,    0x10d,    0,    0,    0,    5
  5099. VESA,    640,    480,    15,    0x4f02,    0x110,    0,    0,    0,    5
  5100. VESA,    800,    600,    15,    0x4f02,    0x113,    0,    0,    0,    5
  5101. VESA,    1024,    768,    15,    0x4f02,    0x116,    0,    0,    0,    5
  5102. VESA,    1280,    1024,    15,    0x4f02,    0x119,    0,    0,    0,    5    ;NOTE: Way cool monitors only!
  5103. VESA,    320,    200,    16,    0x4f02,    0x10e,    0,    0,    0,    0
  5104. VESA,    640,    480,    16,    0x4f02,    0x111,    0,    0,    0,    0
  5105. VESA,    800,    600,    16,    0x4f02,    0x114,    0,    0,    0,    0
  5106. VESA,    1024,    768,    16,    0x4f02,    0x117,    0,    0,    0,    0
  5107. VESA,    1280,    1024,    16,    0x4f02,    0x11a,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
  5108. VESA,    320,    200,    24,    0x4f02,    0x10f,    0,    0,    0,    10
  5109. VESA,    640,    480,    24,    0x4f02,    0x112,    0,    0,    0,    10
  5110. VESA,    800,    600,    24,    0x4f02,    0x115,    0,    0,    0,    10
  5111. VESA,    1024,    768,    24,    0x4f02,    0x118,    0,    0,    0,    10
  5112. VESA,    1280,    1024,    24,    0x4f02,    0x11b,    0,    0,    0,    10    ;NOTE: Way cool monitors only!
  5113.  
  5114. ;VIDEO 7 (VEGA Deluxe, 1024i, VRAM VGA
  5115. VID7,    80,    43,    0,    0x6f05,    0x40,    0,    0,    0xb800,    0
  5116. VID7,    80,    60,    0,    0x6f05,    0x43,    0,    0,    0xb800,    0
  5117. VID7,    80,    67,    0,    0x6f05,    0x46,    0,    0,    0xb800,    0    ;may not be present (undocumented)
  5118. VID7,    100,    60,    0,    0x6f05,    0x44,    0,    0,    0xb800,    0
  5119. VID7,    132,    25,    0,    0x6f05,    0x41,    0,    0,    0xb800,    0
  5120. VID7,    132,    28,    0,    0x6f05,    0x45,    0,    0,    0xb800,    0
  5121. VID7,    132,    43,    0,    0x6f05,    0x42,    0,    0,    0xb800,    0
  5122. VID7,    1024,    768,    1,    0x6f05,    0x63,    0,    0,    0,    0
  5123. VID7,    1024,    768,    2,    0x6f05,    0x64,    0,    0,    0,    0
  5124. VID7,    720,    540,    4,    0x6f05,    0x61,    0,    0,    0,    0
  5125. VID7,    752,    410,    4,    0x6f05,    0x60,    0,    0,    0,    0
  5126. VID7,    800,    600,    4,    0x6f05,    0x62,    0,    0,    0,    0
  5127. VID7,    1024,    768,    4,    0x6f05,    0x65,    0,    0,    0,    0
  5128. VID7,    640,    400,    8,    0x6f05,    0x66,    0,    0,    0,    0
  5129. VID7,    640,    480,    8,    0x6f05,    0x67,    0,    0,    0,    0
  5130. VID7,    720,    540,    8,    0x6f05,    0x68,    0,    0,    0,    0    ;ONLY exists with V-RAM VGA
  5131. VID7,    800,    600,    8,    0x6f05,    0x69,    0,    0,    0,    0    ;ONLY exists with V-RAM VGA
  5132. VID7,    1024,    768,    8,    0x6f05,    0x6a,    0,    0,    0,    0    ;ONLY exists with V-RAM2 VGA
  5133. :::
  5134.